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Chapter 1 WHAT BASE OFFER YOU 


The major function that BASE offers can be devided into four categories: Programming in BASIC language, 
Programming in ASSEMBLY language, word processing, and entertainment. 


PROGRAMMING IN BASIC LANGUAGE 

If you are on Old Hand at programming, you will find some new features and conveniences in BASIC that 
make programming a lot more fun. If you are a Newcomer to-programming, you will also find many 
features and conveniences in BASE BASIC that make programming a lot of fun. 

The chapter 3 will give a tutorial for a Newcomer, chapter 4 is a detail for Old Hand. 


PROGRAMMING IN ASSEMBLY LANGUAGE (BASE 64A only) 


BASE offer yor a tiny-Assembler that helps you to write Assembly language program, and gives you 
debugging command which you can trace your Assemb]y language program, detail in the chapter 5. 


WORD PROCESSING (BASE 64A only) 

BASE has a built in Mini-Writer,.when doing the word process it will make a great deal of convenience. 

The outstanding features of Mini-Writer are: 

1. Mini Writer is a menu-driven system and is friendly to use. 

2. Mini Writer has an “undelete” feature which allows recovery of up to 256 characters that have been 
deleted. This can also be used as a simple method of moving text. 


ENTERTAINMENT 


BASE has many software for entertainment, you can contact with your computer dealer for the listing ot 
software. . 
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Chapter 2 HOW TO OPERATE BASE 


This chapter will show you how to operate and set up your BASE and will be a guide as you learn to 
program it. 


2—1 WHAT YOU WILL NEED 


In addition to the BASE, you will need two more items chosen from the options below. 


1. You will need one of the following items (it’s useful to have both, but only one is necessary). 
a. The disk drive with a controller card. 

OR 
b. A cassette recorder with cable. 


2. You will also need one of the following items: 
a. A color TV monitor and a cable that has a phono plug (also called a male RCA-type con- 
nector) at one end and something to match the monitor at the other end. 


OR 
b. An ordinary home color TV and an ‘’RF Modulator” with the connecting cables. The RF 
Modulator changes the signal out put by the BASE so that it matches what your TV expects. 


2—2 HOOKING UP THE SCREEN DISPLAY 


If you have a color (or black and white) monitor, just connect the appropriate cable from the jack 
marked VIDEO OUT (on the rear of the BASE) to the input of the monitor. 


If you have an ordinary TV, you will have to install an RF modulator. Open the top of the BASE by 
pulling straight up on the back of the lid using both hands,-one on each side. Then install the 
modulator following the directions that come with it. 


The Modulator comes. with instructions on how to hook it up. Your TV’s ability to receive normal 
programs will not be diminished (or enhanced) by having the BASE hooked up to it. 


A black and white monitor or TV will work fine, but will not let you take advantage of BASE’s ability 
to generate color pictures. 


2—3 THE CASSETTE RECORDER 
(if you are not using a disk drive, or if you are going to use both recorder and disk) 


Use the cable (the one with two plugs on each end) to connect the BASE to your cassette tape 
recorder. Connect one black plug to the MIC or MICROPHONE jack on the recorder, and the other 
black plug (on the opposite end of the cable) to the jack on the back of the computer marked 
CASSETTE OUT. Connect the grey plug on the recorder end of the cable to the recorder’s EAR or 
EARPHONE or MON or MONITOR jack on the recorder (different brands use different words). 
Connect: the grey plug on the computer end of the cable to the jack CASSETTE IN. “OUT‘’’ means 
“out of the computer” and ‘IN’ means “into the computer.” All that remains is to plug the cassette 
recorder’s power cord into a wall outlet, and it will be ready to use. 


Now close the top of the BASE. Plug the BASE end of tre computer's power cord into the BASE (on 
the rear of the BASE next to the power switch), and the other end into a three-prong grounded wall 


Outlet. Now the BASE is completely set up, and you have only to read on to begin exploring the 
fascinating world of personal computing. 


2—4 THE DISK DRIVE AND PRINTER 
When you want to use Mini-Writer to creat a document, you need both Disk Drive and Printer. 


THE DISK DRIVE SET UP 


First off the power, remove the top of BASE, in the rear side, you can see eight slot, plug your disk 
controller card into one of them will be fine except slot 0, then insert your System Master Disk 
carefully, now turn on the power, you disk drive is at the service now! 


THE PRINTER SET UP 


When use Mini-Writer BASE needa printer and all printers can be match with BASE, set up the printer. 
is almost the same as disk driver, the only difference is printer has it’s own power. 


2—5 TURNING ON THE POWER 


Check that all the system components are connected together correctly and turn on the television set. 
Turn the volume all the way down. Locate the slide ‘switch hanging from the TV antenna terminals 
and set it on the GAME or COMPUTER setting. Select the channel specified by the RF modulator 
instructions. If you don’t know which channel to use, ask sOmeone else who uses the system or @ 
dealer who sells the RF modulator. 


Locate the power switch on the rear of the BASE next to where the power cord plugs into the 
computer. Turn the switch ON. You should hear a sound from inside the BASE. The sound tells you ~ 
the BASE is ready. The POWER lamp on the keyboard will be on now unless it’s burned out. 


*In the PAL system area, base must add PALCARD to connect with T.V. 


If you did not hear a sound, turn the switch OFF, then ON again. If you still do not hear anything; 
turn the power OFF. Was the POWER lamp lit? If it was not, unplug the BASE and plug in a lamp 
or a raido the see if the wall outlet has power. Read the instructions again and double check to make 
sure system components are hooked up properly. If the BASE still won't start, TURN THE POWER 
OFF! Unplug the BASE and get help from someone with more experience (your dealer). You can do 
a lot of harm by poking around the insides or switching connecting wires around. 


2—5—1WHAT YOU SEE ON THE TV 


Once the power is on, and you hear the BASE sound indicating everything is all right, an image 
will appear on the TV screen. 


The exact image will depend on which variety of BASE you have, but one thing on the screen 
should be quite obvious because it will be blinking on and off at regular intervals. This flashing 
dash is called the cursor. It marks the location where the next character you type will appear 
on the screen. 


Your BASE may have the Disk drives, In this case, you won't see a cursor, Instead there will 
be some whirring and clacking noises coming from the disk drive, and the red IN USE lamp on 


the front of disk rive cabinet will light up. 


For the time being, when this happens press the RESET key the Cursor will appear and the 
disk drive will quiet down. 


TABLE 2-1. Prompt Characters 


Monitor 


Tiny Assembler (BASE 64A only) 
BASIC 


2—5—2 THE PROMPT CHARACTER 
To the left of the cursor there is another character. It is the first character on the line. It could 
be an asterisk (*), a greater-than symbol (>), or a right bracket (]). The BASE is a multilingual 
computer and the prompt character indicates which language it expects its instructions in. 
Table 2-1 shows the three prompt characters and their corresponding languages. 
* is the Monitor 
_ The asterisk is the prompt for BASE. Assembly Lanauage Monitor. Generally only advanced 
BASE users need to communicate directly with the Monitor. If you wish to:experiment with ' 
the Monitor, you may do so now. While you can’t do any harm by playing with the Monitor at 
this time, you will have to turn the power OFF and then ON again to under the results of your 
experimenting. 
> Tiny Assembler (BASE 64A only) 
The > prompt indicates that the BASE is ready for instructions in Tiny assembler have many 
things in common. For now we will stick to instructions that you can use in either version, so 
you need not worry about which BASIC you’re using. 
] is BASIC 
The ] prompt tells you the BASE is ready in BASIC 
2—6 THE KEYBOARD OF BASE 

When power is on, the LED in left side of keyboard will light up, this means the power of the BASE, 

at the normal condition, when power on the screen will display the following: 

BASE 64A 

] 


The standard BASE keyboard has 72 keys, it is different from common typewriter, when you are 
familier with it, you will find it will let you have a lot of convience. 


Every key of the BASE keyboard ‘has two functions at least, their functions we will discuss in 
following: 


ER) OPE 


er 


fais 


| 


At normal condition the BASE Keyboard’s function is marked on the center of every key. 


. When any key is being pressed with F2 key, the function marked on the bottom side of the key 


will be executed or store into buffer. For example: 


] 

] LOAD = LOAD 
] 

] SAVE : (F2°S]= SAVE 


When | SHIFT LOCK] key is being locked, the letter key you type in will display in lower case, 
the other key you type in will be transferd to symbol which marked on the center top of the key. 


. When any key is being pressed with [SHIFT] key the keyboard will recongize it as asymbol or 


lower-case letter, if | SHIFT LOCK | is locked at the meantime.the function will inverse. 


When any key is being pressed with CTRL key the keyboard will treat it as control character, this 
won't display on the screen, but it will cause BASE to execute certain kind of action; for example: 


TRE -f when you are writing a basic program this command can help. you insert 
character. 
this command can help you delete character when editing program (BASIC). 


you can use this command when you want to stop the program (BASIC) 
which is in executing. ‘ 


(CTRL D) CTRL CTL [CTRL K] [CTRL] (CTAL FP] (CTRE S ETRE SJandicTRL Y| (CTRL _Y] these comand is 


useful in MINI-WRITER. 


When any key is being pressea with ESC key the function which marked on center top of the key 
will be executed immediatly. 


At the right side of the keyboard is a keypad when [_F1 ] key is locked the function marked on 
the bottom of the key will active. 


the keyboard of BASE is very powerful as you see in proceeding discussion, try it, and you will find it 
is intellegent. 


8. 


If you BASE is 48 type or 64 type above rules is not exist. 
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Chapter 3 A TUTORIAL OF BASIC 


Before we start to intorduce the BASIC Language of Base, we think we should let you know tha> BASE 
offer you a one-key command set; and this command set can give you a very great convinence. If you are 


confuse of the one-key command (BASE 64A only) we think you should read section 2.6 again before we 
continue this chapter. 


3—1 HOW TO USE PRINT STATEMENT 


3—1—1 PRINTING CHARACTERS 


3-1-2 


When you first put the BASE in BASIC, ‘it is in immediate mode, also called calculator mode. 


In this mode, the computer responds immediately to any instructions you issue it. Try typing 
in this example: 


]PRINT “PLEASE, DO IT YOURSELF.” 


Don't forget to press the RETURN key after the last quotation mark. The BASE prints the 
following message: 


PLEASE, DO IT YOURSELF. 


‘If the BASE prints the message? SYNTAX ERROR or *** SYNTAX ERR, it is telling 


your command was indecipherable. You probably misspelled the word PRINT or lost the 
‘quotation mark. In either case, you have to type the instruction in again. 


A command like the one above instructs 


the computer to print everything between: the 
quotation marks onto the display screen 


There is a limit to the length of the message you can put between quotation marks. 


BASE allows 255 characters. As 


you approach the limit, the BASE starts beeping. When you 
exceed the limit, it prints a back 


slash (/) and automatically enter your command into buffer. 


Try this: 


] PRINT “NORMALLY, STATEMENTS ARE EXECUTED 
IN THE ORDER OF WHICH THEY APPEAR IN T 
HE SOURCE PROGRAM.” 


NORMALLY, STATEMENTS ARE EXECUTED IN THE 


ORDER OF WHICH THEY APPEAR IN THE SOURC 
E PROGRAM. 


PRINTING CALCULATIONS 


You can use the BASE in immediate m 


Ode as you would a Calculator 
with the answers to arithmetic calculation 


s. Try these examples: 


]PRINT 5+6 . Addition, + 
1] 


; it responds directly 


r 


SS eS SS SS ee ee 


¥ 


’ M ¢ \ 4 —— LK j 


3—1+3 


] PRINT 500-487 Subtraction, — 
13: | 


] PRINT 100*11 Multiplication, * 
1100 


] PRINT—96/12 Division, / 
-~8 


] PRINT 8A2 Exponentiation, A 
64 


] PRINT 3*4*10-100 Combination 
20 


] PRINT (10+20)/(6*[2+3]) 
1 


] PRINT (10+20)/6*(2+3) 
25 


As including a comma (,) in a PRINT statement causes it to space over to the next tab field 
before the value following the comma is printed. If we use a semicolon (;) instead of a 


comma, the next value will be printed immediately following the previous value. Try it. 


Try the following examples: . 


] PRINT 1, 2,3 
l 2 3 


] PRINT 1;2;3 
123 


] PRINT -1; 2; -3 
19.3 


If you are bothering in type P, R, I, N, T five keys to present the state of PRINT. We teach 
you a simple way to avoid this problem. You can type the ‘’?’’ question mark take the place 
of PRINT. | 

] 10 PRINT “I LOVE YOU.” 

is totally the same as. 

‘} 10?“I LOVE YOU.” 

Formation of numbers 

Type 


] PRINT 24.649 
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Your computer responds with 


24.64 


and didn’t PRINT the trailing zero. The BASE not PRINT leading or trailing zeros, that is, 
zeros, that are at the beginning of a number and to the left of the decimal, or Zeros that are at 
the end of a number and to the right of the decimal. 


Very, very small numbers (between about. 0O0O000000000000000000000000 
000000000 3and-~-. 00000000000000000000000000000000003) 
will be converted to zero by the BASE. An easier way to write these numbers is 3 * 10A— 
39 and —3 * 10A~— 39. Don’t take our word for it. Try it and do it yourself. 


Now type 


PRINT 123456. 8901 


Surprise! The last two digits are lost, and the number left behind is the closest approximation 
the computer can think of. This process is called “rounding”. Try typing 


PRINT 788. 6898 


Your computer did not round the number, but PRINTed it just the way you typed it. 
Numbers are rounded only if they have more than nine digits. Any number that has fewer 
than ten digits will not be rounded. The computer does the best it can, but it only has nine 
digits to work with. 


If yor type a PRINT statement with a long number like 

1234567890 

the BASE responds with 

1. 23456789E+0 9 

The number 1. 23456789E+09 and 1234567890 have the same value. 


When a number is printed, the following rules are used to determine the exact format: 

1) If the number is negative, a minus sign (—) is printed. 

2) If the absolute value of the number is an integer in the range 0 to 999999993, it is printed 
as an integer. 

3) If the absolute value of the number is greater than or equal to. 01 and Jess than 9999999 
99.2, the‘number is printed in fixed point notation, with no exponent. 

4) If the number does not fall under categories 2 or 3, scientific notation is used. 


Scientific notation is used to print real precision numbers, and is formatted as follows: 
SX. XXXXXXESTT 
Where each X is an integer C to 9. 


PRECEDENCE OF MATHEMATICAL OPERATIONS 


In asimple calculation like 


---| 


ee | 


se hes Hitec, ee, A A fa i 


7 
a a 


— — 


]PRINT 4+8/2 


You can’t tell whether the answer should be 6 or 8, until You know in which order (or 
precedence) to carry out the arithmetic. If you add the 4 to the 8, you get 12, then divide 
12 by 2, you get 6. That's one possible answer. However, if you add 4 to eight-divided-by- 
two, you have 4 plus 4, or 8. This is another possible answer. Eight is the answer your BASE 
will give. Here's how the BASE chooses the order in which to do arithmetic: 


1. When the minus sign is used to indicate a negative number, for example 
—-8+2 


the BASE will first apply the minus sign to its appropriate number or variable. Thus —8 + 2 
evaluates to —6. If the BASE did the addition first, -8 + 2 would evaluate to —10. But it 
doesn't. 


2. After applying all minus signs, the BASE then does exponentiations. The expression 
8+ 3A2 


is evaluated by squaring three (three times three is nine), and then adding four, for a grand — 
total of 17. When there are a number of exponentiations, they are done from left to right, so 
that 


2A3A2 


is evaluated by multiplying 2 by itself three times (2*2*2) which is eight, and then multi- ~ 
plying that by itself (8). The answer is 64. 


3. After allexponentiations have been calculated, all multiplications and divisions are done, 
from left to right. Arithmetic operators of equal precedence are always evaluated from left 
to right. Multiplication (*) and division.(/) have equal precedence. 


4. Lastly, all additions and subtractions are done, form left to right. Addition (+) and 
subtraction (—) have equal precedence. 


Let’s summarize the BASE’s order of precedence for carrying out mathematical operations: 


First: . (minus signs used to indicate negative numbers) 
Second: A (exponentiations, from left to right) - 

Third:. * / (multiplications and divisions, from left to right) 
Fourth: + — (Additions and subtractions, from left to righ) 
12 /(3+(1 + 2)A2) 


In this case, doing the innermost parentheses, you first add 1 T 2. Now it becomes, 


12/(3 +342) 


and you know that (3 + 32) is 12, so the answer of the example has been simplified to 
12/12, which is one. 


Therefore, you know the bracket ( ) appears in a calculation instruction, the mathematic 
calculation of the innermost parentheses must be done first. That means the computers take 
the precedence of prentheses beyond every mathematical operations. 


Unless you have a lot of experience with the way computers evaluate expressions, you should 
actually do these examples. Don't do them all at once and then check with the computer. Do 
an example by hand and then do it on the computer. Then go on to the next one, and so on. 


4+6-2+2 
8*4 
8A2+1 
6/4+1 
(5-4)/2 
4/2-2 

6* —-2+6/(3+8) 
4+-2 
2A(2A3)+1 
2*2*3+1 
2*2+1%*3 
2 * 2 * (1+ 3) 


.8/2/2/1 


3—1—5 


8*2/2+3*2A2* 1 


(26/2%*5 


No answers are given in this book. Your BASE will give you the correct answers. 


DELETE PROGRAM LINES 


To delete an entire line, type its line number followed immediately by [RETURN] . When 


you list the program, you will see that the line and line number are canceled in the program. 


example: 


]NEW 
]00 PRING “GARBAGE IN, GARBAGE OUT.” 
]10 PRING “I GIVE MY BELIEVE TO YOU.” 


]20. PRINT “DATA IS PREPARED FOR YOUR 
COMPUTER.” 


-]30 PRINT “LOOK BEFORE YOU LEAP.” 


]40 PRINT “YOU ARE A GENIUS IN CHEMISTRY.” 
]50 END 


]10 ;DELETE YOUR PROGRAM LINE 10 


]LIST 
00 PRINT “GARBAGE IN, GARBAGE OUT.” 


20 PRINT “DATA IS PREPARED FOR YOUR 


COMPUTER.” 
30 PRINT “LOOK BEFORE YOU LEAP.” 
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40 PRINT “YOU ARE A GENIUS IN CHEMISTRY.” 
50 END 


You can also use the command DEL to delete a block of program lines. For example: 
DEL 20, 40 


]LIST 


0 PRINT “GARBAGE IN, GARBAGE OUT.” 
50 END 


The command DEL 0,50 deletes all the program lines between line number 0 and 50. 


Another command also has the function to delete a program line. TYPE the[CTRL- 
X]at no matter which program line you are in. The computer disregards the current display 
line, shows a “'/’’ mark on the screen, and meantime moves the cursor to the left margin on 
the next line down. 


]NEW 
]10 PRINT 35+3 
]20 PRINT 35-3 ‘ 


At line number 20, press|CT RL-X| key instead of,RETURN, 
]20 PRINT 35-2/ 
Then list the program 


]LIST 
10 PRINT 35+3 


ADDING PROGRAM LINES 


You can type in new program lines at any time, in any order, their line numbers will deter- 
mine their new position in the program. The micro computer will automatically merge them 
in the program. Try adding lines into the example above. 


]5 PRINT “ABC” 
]20 PRINT 35-3 
]LIST 
5 PRINT “ABC” 
10 PRINT 35+3 
20 PRINT 35-3 


THE LOGIC AND ITS RESULT. 
The BASIC can distinguish between what is true and what ts talse. Since this is more than 


most of us can do, a few words of explanation are in order. The symbol > means ‘greater 
than’’. The assertion 8 > 2 is certainly true. The BASIC uses the number 1 to indicate truth. 


If you type 


PRINT 8> 2 


the computer will reply with a one. The assertion 55 > 88 is false. The BASIC uses the 
number 0 to indicate falsehood. 


If you type 
PRINT 55 > 88 
the computer will reply with a zero. 


The symbol < means “‘less than’’, and you can make statements using it as well. Here are the 
symbols used in making assertions: 


greater than 

less than 

equal to 

greater than or equal to 
= less than or equal to 

> not equal to 


Cai yt AY 


Think about and then test to see which of these assertions are true, and which are false. 


5<>5 
6>4 

8>8 

18 <=8 

9534 <= 4359 
5<8 

45 >= —45 
—-8<=-7 
—3>=—-5 
9<> -8 


Assertions can include variables and expressions as well as numbers. For example 


]PRINT (4*6) <> (4+ 6) 


will print the value 1 since 24 is not equal to 10 (remember that 1 means the assertion is 
true). 


ABLE =5 

and 

BASE = 19 

then the assertion 
ABLE > BASE 

is false. But if 
ABLE = —8 - 

and BASE = —15 
then the assertion 


ABLE > BASE 
‘is true. 


Assertions have the numerical values of zero or one. They can be used in arithmetic ex- 


pressions instead of ones and zeros. For example, 
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+14 


Ly hy hy Ly 


For example, 
PRINT 8 + (4> 2) 

will print the value 9. The statement 
T=4<>3 


gives T the value 1, since 4 does not equal three, and thus the assertion 4 <> 3 has the 
value 1. The statement 


LON = 64= 19 


looks very confusing at first, but it is easily understood. Since 64 does not equal 19, the : 
assertion 64 = 19 is false and has the value zero. The value of 0 is given to the variable “LON” 


As we have seen, the BASE uses 1 to mean true, and 0 to mean false. If something is not true, 
it is false. If something is not false, it is true. . 


]PRINT NOT 1 

and thentry . 

]PRINT NOT 0 

The computer agrees: not ture is false and not false is true. 
Of course, you can use expressions instead of ones and zeros. 


For example 


]PRINT NOT (45 > 13) 
]PRINT NOT (123 <= 100) 


How to determine whether an assertion containing the connecting word AND is true or false? 


_ Test your,computer with the following instructions; try to predict each answer: 


]PRINT 1 AND 1 

]PRINT 1 AND 0 

]PRINT 0 AND 1 

]PRINT 0 AND 0 

]PRINT (3>2) AND 0 
]PRINT (NOT 0) AND (4=5) 


In general, when you combine two sentences, or assertions, by joining them with the word 
AND, you find that 


a. The new sentence is true if both original sentences were true. 
b. The new sentence is false if at least one of the original sentences was false. 


In general, when you combine two sentences by joining them with the word OR, you find 
that 


a. The new sentence is true if one or both of the original sentences were true. 
b. The new sentence is false if both of the original sentences were false. 
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The BASE can also determine if an assertion containing OR is true or false. Try each of these 
on your BASE--after figuring out what the answer should be. 


] PRINT 1 OR 1 
] PRINT 1 OR O 


] PRINT 0 OR 1 : 
] PRINT 0 OR 0 

] PRINT (4 <> 15) OR (4>8 5) 

] PRINT 0 OR (0 AND 1) ! 


] PRINT ([3>14] OR [54 < 337]) AND (NOT 4) 
And, OR, and NOT will become very useful in the next section. 


While the following box gives the precedence rules for AND, OR, and NOT, we sincerely 
~ recommend that you use parentheses to make your statements clear. 


3-1-7 PRECEDENCE FOR OPERATIONS 


oat 

2. — (for negative values), NOT , 
a 
ae 5 

5.+,- 

et ae oe j 
7. AND 

8. 


OR 


3-2 NEW, LIST, RUN, HOME 


NEW has to be followed by a[RETURN| To tell the computer to store a statement, just type a number 
before typing the statement. If you type 


]100 PRINT 3+4 


nothing seems to happen, even if you press RETURN. The computer has stored the statement. To see 
that it has stored in the computer, you type the instruction 


LIST 


100 PRINT 3+4 
appears on the screen. Now type the statement 


]RUN 


and the answer 7 appears on the screen. 
Z 
Typing RUN caused your stored statement to be executed, but the computer has not for gotten the [ 
statement. You can RUN the same statement as many times as you like 


HOME 


The HOME command has the same effect as you type 


Meats te €,6& ty 


(LA ee bes 


_—— 


ESC , then SHIFT § 
To try this out type 


]3¢¢ HOME 
]RUN 


or 


]HOME 


Of course, followed by [RETURN] command, the computer clears the screen totally. 


3-3 GET, LET 


3-3-1 THE GET STATEMENT 


The GET statement, inputs a single character from the keyboard. It does not display the 
character on the screen. You do not press RETURN after typing the character. The entry is 
treated as a string value or as a numeric value, depending on the type of variable that follows 
the word GET. Type in the following program and run it: 


REM IF ENTRY IS A “Z”, END PROGRAM. 
GET A$ 

PRINT A$ 

IF A$ = “Z” THEN END 

GOTO 10 


When this program RUN, type any character or number you like, the computer displays the 
character or number what you just typed. But it will stop as you pressing Z. 


We can make GET wait for a specific character by testing for the character as follows: 


10 
20 
30 
40 


GET A$ 

IF A$, < > “W” THEN GOTO 10 
PRINT A$ 

END 


This program waits for the letter W to be entered. Nothing else will do. 


3-3-2 THE LET STATEMENT 


Generally used to assign or specify the value of a variable. 


NEW 
§ LETI=5 
10 LET A= 3.147 I 
10 B=A#+I 
15 PRINT A, B 
RUN 
15:7 20.7 


The word LET can be omitted in an assignment statement. It means that: 


10 LET A = 3:14 * I 
and 


10 A=3.14* ] 
are exactly the same., 


Another example: to calculate the length of every side, degrees of angle, and the area of . 


triangle. 


100 LET C=30:B=90: AC=12:T=3.14 
110 BC=AC*COS(c* T/180) 

120 AB=AC*SIN(C* T/180) 

130 S=BC* AB/2 

140 A=180-B-C 

150 PRINT “AB”; AB, “BC="; BC, “AC="- AC 
160 PRINT “A=”; A, “B=”. B; “@=".«C 

170 PRINT “AREA S= “: § 

180 END 


Try this answer out by yourself. 


Notice: at line number 100, the (:) col 
instruction following this precedence C = 30, then B = 90, AC = 12, and T = 3.14 
If you don’t use the colon mark, 


you will need more lines to announce those instructions 
in a program. 


3—4 IF... THEN, GOTO, GOSUB 


3-4-1 


IF ... THEN 


With the statements we've discussed so far, this can not be done, What we need is a statement 
that provides a conditional branch to another Statement. The IF .. . THEN statement does 
just that. 


] NEW 
]io INPUT A 


120 IF A=0 THEN GoTo 50 
130 PRINT “NON-ZERO” 


]40 GOTO 10 
}50 PRINT “ZERO” 
160 GOTO lo 


N, it will print a question mark and 
Type any value you wish. Th 


and the THEN portion of the 


wait for you to type a value for B. 


€ computer will then come to the |F statement. Between the IF 
Statement, there is an “assertion.”’ | 
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on mark gives the order to computer to do the 


ee ee a a ee, ee So, Ee, 
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SYMBOL MEANING 
= EQUAL TO 
> GREATER THAN 
< LESS THAN 
<> or >< NOT EQUAL TO 
<= LESS THAN OR EQUAL TO 
>= GREATER THAN OR EQUAL TO 


The IF statement is either ture or false, depending on whether the assertion is true or not. In 
present program; for example, if 0 is typed for A the assertion A=0 is true. Therefore, the IF 
statement is true, and ZERO will be printed, and then the GOTO statement in line 60 will 
let computer back to line 10. 


Suppose a 1 is typed for A. Since the assertion A=0 is now false, the IF statement is false and 
program execution continues with the next line number, ignoring the THEN portion of the 
statement and any other statements in that line. Therefore, NON-ZERO will be printed and 
the GOTO in line 40 will send the computer back to line 10. 


10 READ X 

20 IF X >=0 THEN PRINT “X=”; X 
30 GOTO 10 

40 DATA -6, 3, 9, —9, 0, 11 

50 END 


THE GOTO STATEMENT 
There is an example: 


]10 INPUT, D 
]110 PRINT 3.1416 * D 
RUN 


? 10 
31.416 


When we want to calculate many circles, we could keep re-running the program for each 
successive diameter. But there’s an easier way to do it, simply be adding another line to the 
program, as follows: 


]120 GOTO 100 
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26.4 
20.10624 
? 


BREAK IN 10 
] 


By putting a GOTO statement on the end of your program, you have caused it to go back to 
line 100 after it prints each answer. This could go on indefinitely, but we decided to stop 
after calculating the circle for three diameters. Stopping was accomplished by typing a 
control C (type C while holding down the{CTRU key) and pressing the[RETURN] key This 
caused a “‘break’’ in the program’s execution, allowing us to stop. Using control C, any 


program can be stopped after executing the current instruction. Try it for youself. 


GOSUB STATEMENT 


This statement branches in the same way as GOTO, but in addition it remembers where to. 


This may be illustrated as follows: 
Subroutine 


2000 #—— Start 


50 GOSUB 2000 


ae RETURN End: 


End the subroutine with a RETURN stement. This statement causes a branch back to the 
statement -following the GOSUB statement. If the GOSUB is the last statement on the line 
the program returns to the first statement on the next line. 


10 REM MAIN PROGRAM 
20 DIM A(99) 
30 GOSUB 1000 
40 PRINT “RETURNED” 
50 END 
1000 REM SUBROUTINE 
1010 FOR I=0 TO 99 


1020 A(I) =I 
1030 PRINT A(I) 
1040 NEXT I 


1050 RETURN 

. DATA, FOR...NEXT, FOR...TO 

READ...DATA 

Suppose you want your program to use numbers that don’t change each time the program is 


run, but which are easy to change if necessary. BASIC contains special statements for this 
purpose, ce'led the READ and DATA statements. 
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Consider the following program: 


] NEW 
]10 READ W . 
]20 IF W<=0 THEN PRINT “W=”; W 
130 GOTO 10 
140 DATA -6, 3, 9, -9, 0, 11 
150 END 
] RUN 
W=-6 
W=-9 
W=0 


When the READ statement is encountered, the effect is the same as an INPUT statement, but 
take the palace of getting a number from the keyboard, a number is read from the DATA 
statements. 


The first time a number is needed for a READ, the first number in the first DATA statement 
is returned. The second time’s loop another data is needed, the second number in DATA 
statement is provided. DATA is always read sequentially in this manner, and there may be 
any number of DATA statements in your program. 


DATA statements may be placed anywhere within the program. Only READ statements 
make use of the DATA statements in a program, and any other time they are encountered 
during program execution they will be ignored. 


FOR...NEXT, FOR... TO, 


110 N=1 

120 PRINT N 

130 N=N+1 af) 

140 IF NT=10 THEN GOTO 120 


When this program is RUN. Let’s look at how it works. 


In line 110, there isa LET statement which sets the variable N to the value 1. At line 120, the 
computer is told to print N. 


At line 130, there is what appears at first to be a rather unusual LET statement. The im- 
portant thing to remember is that in a LET statement, the symbol ‘’="’ does not signify 
equality. In this case ‘=’ means ‘‘to be replaced with ‘’. The statement simply takes the 
current value of N and adds 1 to it. Thus, after the first time through line 130, N becomes 2. 


At line 140, since N now equals 2, the assertion, N<= 10 is true so the THEN portion sends 
the computer back to line 120, with N now at a value of 2. 


The overal result is that lines 120 through 140 are repeated, each time adding 1 to the value 
N. When N finally equals 10 at line 120, the next line will increment it to 11. This results ina 
false assertion at line 140, the THEN PORTION is therefore ignored, and since there are no 
further statements the program stops. 


the following program: 


110 FOR N=1 TO 10 
120 PRINT N 
130 NEXT N 


The output of the program listed above will be exactly the same as the output of the previous 
« two programs. 


At line 10, N is set to equal 1. Line 20 causes the value of N. At line 30 we see a new type of 
statement. The NEXT statement causes one to be added to N, and then if N <= 10 program 
execution goes back to the statement following the FOR. There is nothing special about the 
N in this case. Any variable could be used, as long as it is the same variable name in both the 
FOR and the NEXT siatements. 


The following program: 


110 N=10 

120 PRINT N 

130 N=N+2 

140 IF N <=20 THEN GOTO 120 


This program can also be written using the FOR loop just introduced. 


10 FOR N=10 TO 20 STEP 2 
20 PRINT N 
30 NEXT N 


Notice that the major difference between this program and the previous one using FOR loops 
is the addition of the STEP 2. This tells BASE to add 2 to N each time, instead of 1 as in the 
previous program. If no STEP is given in a FOR statement, BASIC assumes that one is to be 
added each time. 


FOR loops can also be ‘’nested’’. An example of this procedure follows: 


110 FOR L=1TO5 
120 FOR J = 1 TO 3 
130 PRINT L, J. 

140 NEXT J 


150 NEXT L 


Notice that the NEXT J comes before the NEXT L. This is because the J-loop is inside of the 
L-loop. The following program is incorrect; RUN it and see what happens. 


110-FORL=1TO5 
120 FORJ=1T03 
130 PRINT L, J 

140 NEXT L 

150 NEXT J 


It does not work because when the NEXT | is encountered, all knowledge of the J-loop is 
lost. 
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3—6 INPUT, REM, ARRAY, STRING 


3-6-1 THE INPUT STATEMENT 


3-6-2 


100 INPUT A, B 

110 C=A*B 

120 ‘PRINT A; ‘*”. B; “=": C:, PRINT 
130 GOTO 100 


To run this program, the screen displays a question mark ‘’?"’ and waits you to enter 2 datas 
into Aand B. 


]RUN 
2790 
3*90 = 270 


?10.45+10 
?78.5E2 
1.45E + 10*850 = 1.2325E + 13 


20 

??110 

0*10=0 

212 

2234 

12*34 = 408 

Unlike the LET and READ statement which both allow the supply of constant values to 
variables (values that must be know when the program is prepared), INPUT waits until the 
program is running before actually providing these values. . 
Notice that: 

]10 INPUT A, B$, C 

]20 PRINT A, B$, C 


One enters the following: 
? 3, 4, 10 


It will print out 
3 4 10 


But try to enter this: 
? 3, AAA, KKK 


The computer tells you a message ***? REENTER ***. Because of the variable number C 
must be a value, but the KKK” is a string. 


THE REM STATEMENT 


REM 


This is a remark, and allows to insert a line of text into a program as remarks. The computer 
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won't do any work on it. The good program designer usually use this comment in order to 
mention peoples what the program's purposes are. 


NEW 

100 REM THIS PROGRAM TO COMPUTE SALARY: 
110 LET R=15.00 

120 LET H=160 

130 S=R*H 

140 PRINT S 

63999 END 

RUN 


ARRAYS 


It is often convenient to be able to select any element in a table of numbers. BASE allows 
this to be done through the use of arrays. 


An array is a table of numbers. The name of this table, called the array name, is any legal 
variable name, A for example. The array name A is distinct and separate from the simple 
variable A, and you could use both in the same program 


To select an element of the table, we give A a subscript: that is, to select the I’th element, we 
enclose | in parenthesis (1) and then follow A by this subscript. Therefore, A(I) is the Ith 


element in the array A. 


Whenever an BASIC* program first encounters a subscripted variable, such as A(3), it 
automatically assigns 11 memory locations to the array. These memory locations are assigned 
the names-A(0) — A(10). Thus, if you try to use the name A(11) there is no such memory 
cell name reserved in the computer, and you therefore get’ the error message ?7BAD 


SUBSCRIPT ERROR. 


If you want to use an array with more than 11 memory cells, you must explicitly define the 
array with a DIM (for DiMension) statement. For example, to assign 16 memory cells to the 
array B you would type DIM B(15). You could then use the 16 memory cells B(O) — B(15). 
The constant 15 in the above DIM statement (which could also be a variable or an expression) 
represents the upper subscript limit of the array. The lower subscript limit is always assumed 


to be zero. 


] LIST 

1 DIM A(5): REM A-ARRAY GOT 5 
PRGUMENT! 

2 FOR-I = ¢ TO 4 

3 PRINT “KEY IN A NUMBER!" REM 
PRINT TITLE OF “KEY IN A 
NUMBER!” 

4 INPUT R(I): REM INPUT DATA 
FOR KEYBOARD AND STORE IT IN 
A-ARRAY 

45 PRINT .R(I) 

48 PRINT “A(I)*3=";;: PRINT R(I) 
*3: REM CERTIFY OUR DATA 
IS CORRECT ; 


50 NEXT 


]RUN 

KEY IN A NUMBER! 
?2.356E10 

2.356E+10 
A(I)*3=7.068E+10 
KEY IN A NUMBER! 
723.5 

23.5 

A(I)*3=70.5 

KEY IN A NUMBER! 
2235 

235 

A(I)*3=705 

KEY IN A NUMBER! 
70.235 

.2355 

A(I)*3=.705 

KEY IN A NUMBER! 
?235E10 

2.55+12 
A(I)*3=7.05E+12 
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STRINGS 


A sequence of characters is referred to as “‘literal’’. A “string” is a literal enclosed in 


quotation marks. These are all strings: 


“BILL” 
“THIS IS A TEST” 


Like numeric variables, string variables can be assigned specific values. String variables are 


distinguished from numeric variables by a $ after the variable name. 
For example, try the following: 


] LIST 
]10 A$ = “GOOD MORNING” 


]20 PRINT A$ 
]RUN 
GOOD MORNING 


In this example, we set the string variable A$ to the string value ‘Good MORNING” 


Now that we have set A$ to a string value, we can find out what the length of this value is 
(the number of characters it contains). We do this as follows: 


]20 PRINT LEN (A$), LEN (“YES”) 
]RUN 
12 3 


The LEN function return an integer equal to the number of characters in a string: its 


LENgth. 
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contains 0 characters is called a ‘’null’’ string. Before a string variable is set to a value in the 
program, it is initialized to the null string. PRINTing a null string on the terminal will cause 
no characters to be printed, and the cursor'will not be advanced to the next column. Try the 
following: 


]RUN LEN (Q$); Q$; 3 
0 3 


Another way to create the null striiig is to use 
O$ =" 

or the equivalent statement 

LET Q = 9909 


Setting a string variable to the null string can be used to free up the string space used by a 
non-null string variable. But you can get into trouble assigning the null string to a string 
variable. 


Strings may also be concatenated (put or joined together) through the use of the plus (+) 
operator. Try the following: 


]30 BS = A$ $ gy “BILL” 
]40 PRINT B$ 

]RUN 

GOOD MORNING BILL 


Concatenation is especially useful if you wish to take a string apart and then put it back 
together with slight modifications. For instance: 


]50 C$ = RIGHT$(B$, 4) + “—” + LEFT$(B$, 4) + “—" + MID$(B$,6, 7,) 
]60 PRINT C$ 

]RUN 

BILL-GOOD-MORNING 


Sometimes it is desirable to convert a number to its string representation and vice-versa. The 
factions VAL and STR$ perform these tasks. Try the following: 


]10 STRING$ = “567.8” 

,]20 PRINT VAL‘(STRINGS) 

]RUN : 

567.8 

STRING$ = STR$ (3.1415) 

‘PRINT STRING$, LEFT$ (STRINGS, 5) 
3.1415 3.141 


The STR$ function can be used to change numbers to a certain format for input or ouptut. 
You can convert a number to a string 'and then use LEFT$, RIGHT$, MID$ and con- 
catenation to reformat the number as desired. 
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3—7 GRAPHIC 
3—7—1 THE LOW RESOLUTION 


To enter the low-resolution graphics mode, type GR. When you do this, the screen will clear, 
and the cursor will move to the lower left-hand corner of the screen. 


re ep eee ae | 


In the low-resolution graphics mode the screen is considered to be divided into a 40 x 40 grid 
with four lines of text at the bottom of the screen as shown in Figure 2.1.* The Column 
positions of the grid are numbered 0 through 39 from left to right. The row positions of the 
grid are numbered O through 39 from top to bottom. This is called the Y position or Y 
coordinate. Any one of the 1,600 (40 x 40 = 1,600) small squares or blocks on the grid can 
be identified by giving its X and Y coordinate. For example, in Figure 2.1 the shaded block is 
located at the coordinates X=25, Y=15. 


mL 


—4 


You can plot a colored spot at any of the 1,600 grid positions on the screen. These sports can 
be one of the 16 different colors. To set particular color, type COLOR = C where C can be 
any number from 0—15. For example, the statement COLOR = 13 will set the color to 
yellow. All subsequent spots plotted will be yellow until a new COLOR statement is 
executed. 


ly 


X=0 ae X=39 


oy * Seeeeae8 


3" 


Y=15 7HHH 


Y=39 


Figore 2.1 The low resolution graphics mode divides the screen into a 40 x 40 grid with four ° 
text lines at bottom. 


When you type the statement GR to enter the low-resolution graphics mode, the value of 
COLOR is automatically set to zero (black). Therefore, to plot any spots on the screen you 
must first change the value of COLOR to a number corresponding to another color. 


Once you have set the color, you can plot a spot Located at coordinates, X, Y by typing 
PLOT, X, Y. For example, typing 


]NEW - 
]10 GR 

120 COLOR = 15 : PLOT 25, 15 
]RUN 


will plot a white spot at coordinates X = 25, Y= 15 


’ 
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JCOLOR = 15: PLOT 25, 15 


Plot 25, 15 will plot a spot at location X = 25, Y = 15. 


In order to get out of the low-resolution graphics mode, type TEXT. This will cause the 
BASE to return to the tull screen text mode (24 lines of 40 characters each) with the cursor 
on the last line of the screen. However, the portion of the screen that was associated with the 

~40 x 40 grid in the low-resolution graphics mode will now display the strange-looking 
“garbage”. The screen can be cleared by typing HOME. 


Return to the low-resolution graphics mode by typing GR again. Now type COLOR = 15: 
PLOT 20, 20: PLOT 21, 21 : PLOT 22, 22. The screen should display 3 white spots located 
along a diagonal line. 


The low-resolution graphics commands can be used in the deferred. mode of execution by 
including them in a BASIC program. For example, return to the text mode by typing 


TEXT 
HOME 


and then type in the following program. _ 


10 GR | 
20 COLOR = 15 
30 PLOT 15,30: PLOT 16,31: PLOT 17,32 
40 PLOT 18,33 
50 PLOT 19,32: PLOT 20,31: PLOT 21,30 


This program should plot the V-shaped figure. Note that after this program is run, you are 
still in the low-resolution graphics mode. The only way to get out is to type TEXT. 


20 COLOR = 15 
30 PLOT 15,30: PLOT 16,31: PLOT 17,32 
40 PLOT 18,33 
50 PLOT 19,32: PLOT 20,31: PLOT 21,30 


The BASIC statements HLIN and VLIN can be used to draw horizontal and vertical lines in 
low-resolution graphics. 


HLIN 

Enter the low-resolution graphics mode by typing GR, and set color to white by typing 
COLOR = 15. Then type HLIN 5,30 AT 15. This will cause a horizontal line to be drawn 
‘from X =5 to X = 30 at row Y = 15. 


In general, the statement HLIN X1, X2 At Y will plot a horizontal line from X = X1 to X= 
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X2 at row Y. The values of X1 and X2 must be in the range O—39, and the value of Y must 
be in the range 0O—47; otherwise, the error message ?|_LLEGAL QUANTITY EFFOR will be 


displayed on the screen when the computer tries to execute the HLIN statement. 


Remember that the color of a line is determined by the last number used in the COLOR 


statement COLOR = number. Thus, for example; if you type the statement 


COLOR = 13 
HLIN 20, 30 AT 5 
COLOR = 6 


HLIN 0,39 AT 20 
the computer will plot a short yellow line in row 5 and a long blue line in row 20. Try it. 
VLIN 


Clear the screen by typing 


TEXT 
HOME 


and then reenter the low-resolution graphics mode by typing GR. Set the color to white by 
typing COLOR = 15. Then type VLIN 5,30 AT 15. This will cause a vertical line to be drawn 


from row Y = 5 to row Y = 30 at column X = 15 
Following progam Plot ‘“‘BASE”’ 


10 GR 

20 COLOR = 15 

30 VLIN 0,13 AT 0: VLIN 1,4 AT 5 
: VLIN 6,12 AT 5: HLIN 0,4 AT 
0 

40 HLIN 0,4 AT 5: HLIN 0,4 AT 13 

45 REM ABOVE LINES PLOT A “B” 

50 VLIN 4,13 AT 7: VLIN 4,13 AT 
13: HLIN 7, 12 AT 10: PLOT 7, 
3: PLOT *,2: PLOT 9,1: PLOT 
10,0: PLOT 11,1: PLOT 12,2: PLOT 
13,3 

55 REM ABOV LINES PLOT A “A” 

60 PLOT 15,3: PLOT 16,2: PLOT 17° 
jl: PLOT 18,0: PLOT 19,1: PLOT 
20,2: PLOT 21,3: PLOT 21,4 

70 PLOT 15,4: PLOT 16,5: PLOT 17 
6: PLOT 18,7: PLOT 19,8: PLOT 
20,9: PLOT 21,10: PLOT 21,11 
: PLOT 20,12: PLOT 19,13: PLOT 
18,13: PLOT 17,13: PLOT 16,12: 
PLOT 15,11: PLOT 15,10 

75 REM ABOVE LINES PLOT A “‘S” 

80  VLIN 0,13 AT 23: HLIN 23,28 AT 
0: HLIN 23,28 AT 6: HLIN 23,28 
AT 13 
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85 REM ABOVE LINES PLOT A “E” 


THE HIGH RESOLUTION 


In the high-resolution graphics mode the screen is considered to be divided into a grid with 
160 rows and 280 columns, with four lines of text at the bottom. The column positions of 
the grid are numbered 0 through 279 from left to right. The row positions of the grid are 
numbered 0 through 159 from top to bottom. 


To enter the high-resolution graphics mode, type HOME, and then type HGR. When you.do 
this, the screen will clear, and the cursor will disappear. This is because the cursor is still near 


the top of the screen. Type VTAB 21, and the cursor will show up in the 4-line text area at 
the bottom of the screen! 


Although you:can plot 16 different colors in the low-resolution graphics mode, the number 
‘of colors that you can plot in the high-resolution graphics mode is much more limited. The 
color is set in the high-resolution graphics mode by typing HCOLOR = C where C is a number 
from O through 7. The colors associated with each number may depend on the type of TV 
you are using and the setting of the color and tint controls. For some TVs and settings the 
following colors are associated with each color number: 

. black 

. green (X-odd) . 

. violet (X-even) 

. white (X-even voilet X-odd green) 

black 

red (X-odd) 

. blue (X-even) 

_ white (X-even blue X-odd red) 


NOOARWN=O0 


X=279 


J 


160 x 280 GRID 


Y=159 > 


The high resolution graphics mode divides the screen into a 160 x 280 grid with four lines of 
text at the bottom. 


Note that there are really only ‘four colors, other than black and white. You will find, 
however, that each color cannot be plotted at any location on the screen. For example, violet 
(2) and blue (6) dots can be plotted only in even columns on the screen, while green (1) and 
red (5) dots can be plotted only in odd columns on the screen. A white dot will only appear 
white (on a color TV) if two adjacent dots in a given row are plotted. In addition, it is not 
always possible to plot different colors very close to each other. Normally, you will not have 
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to worry it the colors of all the lines you plot are not exactly what you thought they were 
going to be when you wrote the program. It is probably just a function of the TV and the 
limitation of high-resolution colors in the BASE. 


Set the color to white by typing HCOLOR = 3. You can plot a point at any X, Y location 
(X between 0 and 279 and Y between 0 and 159) by typing HPLOT X, Y. For example, if 
you type HPLOT 140, 80 you should see a small dot near the center of the screen. 


Thé statement HPLOT X1, Y1 To.X2,°Ys will plot a line from the location (X1, Y1) to the 
_location (X2, Y2). For example, type HPLOTO, 0 TO 279, O. They: will plot a horizontal line 
across the top of the screen. 


The statement HPLOT TO X, Y will plot a line from the most recently plotted point to the 
location (X, Y). For example, typing HPLOT TO 0, 159 will plot the diagonal line. This is 
because the point 279, 0 was the last point plotted. 


If you now type HPLOT TO 0,0 the vertical line will be plotted. 


It is possible to plot a sequence of lines in a single statement by using the HPLOT statement 
in the form HPLOT X1, Y1 TO X2, Y2 TO X3, Y3. This statement will plot one line from 
X1, Y1 to X2, Y2 and then will plot a second line from X2, Y2 to X3, ¥3. For example, the, 
statement HPLOT 0,0 TO 279, 0 TO 0, 159 TO 0,0 TO 279, 159 TO 279, 0 will plot the 
pattern. - 


To get out of the high-resolution graphics mode, type TEXT. Note that the screen does not 
get filled with “garbage” as it did when leaving the low-resolution graphics mode. Rather, you 
return to the text mode, and you can see the previous statements that you typed while in the 
high-resolution graphics mode. 


As an example, the program shown in following chart will plot a sequence of concentric 
squares centered at the screen coordinate (140,80). Note that the for .. . next loop 


45 FOR S = .2 to 2 STEP 


85 NEXT S 
has been added to the program given in chart. 


]LIST 

10 REM SQUARE 

20 HGR : HCOLOR = 3 

30 GOSUB 200 : REM FILL ARRAYS 

40 XC = 140: YC = 80 

45 FOR S = .2 TO 1.8 STEP .2 

50 HPLOT XC + X(0) x S,YC + Y(0) * § 
60 FORI=1TOM 

70 HPLOT TO XC + X(I) * S,YC + Y(I) * § 


80 NEXTI | 
85 NEXT S 
90 END 


200 REM FILL X,Y ARRAYS 
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210 M = 4: DIM X(M), Y(M) 
= 1 


0 TO M: READ X(D): NEXT 
0 TO M: READ Y(I): Y(I) 
= -Y(I) / F: NEXT 


250 DATA -—50, 50, 50, —50, —50 
260 DATA 50, 50, —50, —50, 50 


program for plotting circles is shown in following chart. Line 20 clears the screen and moves 
the cursor 


A program for plotting a circle of radius R using high resolution graphics. 


10 REM _ PLOTTING CIRCLES 

20 HOME : VTAB 21 

25 HGR : HCOLOR = 3 

30 INPUT “ENTER RADIUS (1-88) ”"; R 

35 IF R<1OR R> 100 TEN 30 

40 INPUT “ENTER ANGLE STEP SIZE 
(DEGREES) “; S 

50 =PI = 3.1415926:F = 1.1 

60 XC = 140: YC = 80 

70... -HPLOT xXC + R, YC 

80 FOR AD = 0 TO 360 STEP S$ 

90 AR = AD * PI / 180 


100 X =R * COS (AR) 
110 Y = R * SIN (AR) 
1200 Y=-Y/F 


130 HPLOT TO XC + X,YC + Y 

140 NEXT AD 

150 INVERSE : PRINT “ANOTHER PLOT?:: 
NORMAL : PRINT SPC (I): 

160 GET G$ 

170 IF G$ = “Y” THEN 20 

180 TEXT : HOME : END 


program to plot a ploygon figure with from 1 to 15 sides. 


] LIST | 
10 REM POLYGON FIGURE 
‘15 DIM X(13), ¥(15) 
20 HOME : VTAB 22 
30 HGR : HCOLOR =3 
40 PI = 3.14155926:F = 1.1 
50 XC = 140: YC = 80: R = 88 
60 INPUT “ENTER NUMBER OF SICES 
(3-15) “;N 
70 IFN<3ORN> 15 then 60 | 
80 GOSUB 200: REM CALCULATE POINTS 
90 FORJ=1TON-1 
100 FORK=J+I1TON 
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110 


120 
125 
130 


140 
150 
160 
200 
210 
220 
230 
240 
250 
260 
270 


HPLOT XC +. X(J), YC + Y(J) TO 
XC + X(K), YC + Y(K) 

NEXT K: NEXT J 

VTAB 24 

INVERSE : PRINT “ANOTHER PLOT?”;: 
NORMAL : PRINT SPC(I) 

GET G$ 

IF G$ = “Y” THEN 20 

TEXT : HOME : END 

REM CALCULATE POINTS 
FORI=1TON 

AD =I * 360/N 

AR = AD * PI / 180 

X(I) ="R * COS (AR) 

Y¥(I) = R * SIN (AR) 

Y(I) = -Y(I) / F 

NEXT I: RETURN 


Program to plot a sine wave 


]LIST 


10 
20 


REM SINE WAVE 

HOME : HGR : HCOLOR = 3 

PI = 3.1415926 

GOSUB 200 : REM PLOT AXES 
VTAB 24 

PRINT “Y=A*SIN (2*PI*X/T+PHASE)”; 
VTAB 21: HTAB 1 

INPUT “ENTER AMPLITUDE A (0-80) ”;A 
INPUT “ENTER PERIOD T “: T 
INPUT “ENTER PHASE ANGEL ”;PH 
PH = PH * PI / 180 

DEF FN Y(X) = —A * SIN (2 

Pl KT +P) 

X = —140: Y = FN Y(X) 

HPLOT XC + X, YC + Y 

FOR X = — 139 TO 139 

Y = FN Y(X) 

BPLOT TO: 2C-+ %, YC + ¥ 

NEXT X. 

VTAB 24: HTAB 25: INVERSE 
PRINT “ANOTHER PLOT?”; ' 
NORMAL : PRINT.“ ";: GET A$ 

IF A$ = “Y” THEN 20 

TEXT : HOME : END 

REM PLOT AXES 

XC = 140: YC = 80 

HPLOT 0,,YC TO 279, YC 


‘ HPLOT SC,0 TO XC, 159 


FOR X = 0 TO 270 STEP 10 
HPLOT X, YC TO X, YC —5 
NEXT X 

FOR Y = 0 TO 150 STEP 10 
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280 HPLOT XC-—5,Y TO XC+5,Y 
290 NEXT Y 
300 RETURN 


3-8 MUSIC 


BASE have a built in music function, following will show you how to use it. 


First let's demonstrate a song for you! 


]CALL — 11500 
or 


* D314G 


This song just for demonstration, to write a song of your own, remember following rules: 


1. Select note, beat, octave from Music TABLE shown in below. 


2. Put your table at $9000, if your table not at $9000, you must put the start address at $FA 


(Low assress) $FB (High address). 
3. To start playing: 


* D260 G [RETURN 


* E003G 
]CALL—11680 RETURN 


Following Example will show you how it works: 
EX: 


JCALL-151 RETURN 

* 9000: 29 2B 8D 2E 8E 30 Bo 6D 70 8E 2D 6E 6B AD 00 
* D260G RETURN 

* E003G RETURN 


]CALL — 11680 
EX 2: 


JCALL — 151 
* 6000: 29 2B 8D 2E 8E 30 BO 6D 70 8E 2D 6E 6B AQ 00 
* —003G RETURN 


] AUTO 

10 POKE 260,00 RETURN 
20 POKE 251,96 RETURN 
30 CALL-—1167Z RETURN 
40 GO TO 10 RETURN 
60. CTRL. C 


]RUN 
or 


* FA: 00 60 
* D268 G 
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RETURN 


RETURN 


— -— — es | =| a | i — | 


MUSIC TABLE IN HEXDECIMAL FORM 
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. 00 is end 
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MUSIC TABLE IN DECIMAL FORM 


0 is end 


128 
160 


na 
= 
BEE 


Boe ono 08q2 0000020066000 


a 
__ 
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Chapter 4 MORE DETAIL OF BASIC 


4—1 EXECUTION MODES 


im Some instructions may be used in immediate-execution mode (imm) in BASE. In immediate- 
execution mode, an instruction must be typed without a line number. When the RETURN key 
is pressed, the instruction is immediately executed. 


Ex: 
]PRINT “BASE” 
BASE 


def Instructions used in deferred - execution mode (def) must appear in a line that begins with a line 
number. When RETURN key is pressed, BASE stores the numbered line for later use. 
Instructions in deferred-execution mode are executed only when their line of a program is RUN. 


Ex: 
] NEW 
]10 PRINT “BASE” 
]RUN 
BASE 


4—2 SYNTACTIC DEFINATIONS AND ABBREVIATIONS 


The following definitions use metasymbols such as ( and / -- characters used to unambiguously indicate 
structures or relationships in BASE. the metasymbols are not part of BASE. In addition to the true 
metasymbols, the special symbol: = indicated the beginning of a complete of partial definition of the 
term that is to the left of: = 


| : = metasymbol used to separate alternatives 
_ (note: an item may also be defined separately for each alternative) 
] := metasymbols used to enclose material which is optional 
) := metasymbols used to enclose material which may be repeated 
: = metasymbol used to encluse material whose value is to be used: the value of x is written /x/ 
:= metasymbol which indicates a required space 


metasymbol 
2= WN ADA 


lower-case letter 


-= a/b/c/d/e/f/g/h/i/j/k//m/n/o/p/a/r/s/t/u/v/w/x/y/z 


metasymbol 
-= lower-case letter 


digit 
:= 1/2/3/4/5/6/7/8/9/ 


metaname 
-= (metasymbol) [digit] 


metasymbol 


:= a single digit concatenated to a metaname 


special symbol used by BASE 


= special 
special 
S= 1/#/$/%/&/'/(1)/*/:/=/—/@/41;121//Vel 1/177" 
Control characters (characters which are typed while holding down the CTRL key) and 
the null character are also specials. BASE uses the right bracket (]) only for the prompt 
character; right bracket (]) only for the prompt character; in this document it is used as a 
metasymbol. 
letter. Ss 
>= A/B/C/D/E/F/G/H/1/5/K/L/M/N/O/P/Q/R/S/T/U/V/W/X/Y/Z 
character 


= letter/digit/special 


alphanumeric character 
= letter/digit 


name 
= letter[(letter/digit)] 
A name may be up to 238 characters in length. When distinguishing one name from another, 
BASE ignores any alphanumeric characters after the first two. BASE does nct distinguish 
between the names GOOD4LITTLE and GOLDRUSH. However, even the ignored portion of 
a name must not contain a special, a quote (4’) or any of BASE “‘reserved words.’ 


la 
[+/—] (digit) 
Integers must be in the range —32767 to 32767. When converting non-integers into integers, 
BASE may usually be considered to turncate|the non-integer to the next smaller integer. 
However, this is not quite true in the limit as the non-integer SPergomes the next larger 


integer. 

For instance: 

A% = 123.999 999 959 999 B% = 123.999 999 96 
PRINT A% PRINT A% 

123 124 

C% = 12345.999 995 999 D% = 12345.999 996 
PRINT C% PRINT D% 

12345 12346 


(Spaces added for easier reading) 
An array integer occupies 2 bytes (16 bits) in memory. 
integer variable name 


;= name% 
A real may be stored as an integer variable, but BASE first converts the real to an integer. 


{enum 


Ss | 


== 


[es |] 


+/—] (digit) [.(digit)] [E[+/—] digit [digit] ] 

+/—] [(digit)] . [(digit)] [E[+/—] digit [digit] ] 

The letter E, as used in real number notation (a form of “scientific notation”), stands for 
“exponent.” It is shorthand for *10 * Then is raised to the power of the number on E's right, 


and the number on E’s left is multiplied by the result. 


In BASE, reals must be in the range -1E38 to 1E38 or you risk the 7OVERFLOW ERROR 
message. Using adcition or subtraction, you may be able to generate numbers as large as 
1.7E38 without receiving this message. 


1. real whose absolute value is less than about 
2. 9388E—39 will be converted by BASE to zero. 


BASE recognizes the following as reals when presented by themselves, and evaluates them as 
zero: 


#. -. .E +.E —_E 
-E+ E- +.E-— +.E+ —.E+ —.E- 


Therefore, the array element M(.) is the same as M(0) 


In addition to the abbreviated reals listed above, the following are recognized as reals and 
evaluated as zero when used as numeric responses to INPUT or as numéric elements of 


DATA: 


* — E +E— —-E space 
E+ E-—  +E+ +E— —E+ —E- 


The GET instruction evaluates all of the single-character reals in the above lists as zero. 

When printing a real number, BASE will show at most nine digits (see exception, below), 
excluding the exponent (if any). Any further digits are rounded off. To the left of the 
decimal point, any zeros preceding the leftmost non-zero digit are not printed. To the right of 


the decimal point, any zeros following the rightmost non-zero digit are not printed. If there 
are no non-zero digits to the right of the decimal point, the decimal point is not, printed. 


Rounding can be curious: 


PRINT 99 999 999.9 
99 999 999.9 


PRINT 99 999 999.90 
100 000 000 


PRINT 11.111 111 450 00 
Licti? TED§ 


PRINT 11.111 111 451 9 
11.111 111 4 


(Spaces added for easier readin) 
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If a real’s absolute value is greater than or equal to .01 and less than 999 999 999.2, the real 
is printed in fixed-point notation. That is, no exponent is displayed. In the range .0 100 000 
000 5 to .0 999 999 999 reals are printed with up to ten digits, including the zero im- 
mediately to the right of the decimal point. This is the only exception to the limit of nine 
printed digits, excluding the exponent. 


lf you attempt to use a number with more than 38 digits, such as 
20741400911 0091 0007110000100 1-011 

then message 

?OVERFLOW ERROR 

is printed, even if the number is clearly within ie range —1E38 through 1E38. This is true 
even if most of the digits are trailing zeroes, as in 
211.000000000000000000000000000000000000 

Leading zeros, however, are ignored. If the first digit is a one, and the second digit is less than 
or equal to six, numbers with 39 digits may be used without getting an error message. 


A real occupies 5 bytes (40 bits) in memory. 


real variable name 


name 


arithmetic variable 


= avar 
avar 
= name | name% 
All simple variables occupy 7 bytes in memory, 2 bytes for the name and 5 bytes for the real 
or integer value. 
' delimiter - 


VA) I=1—F 41 S/F: 
A name does not. have to be separated from a preceding or following reserved word py any of 
these delimiters. 


arithmetic operator 


aop 


aop 


= +/-I*I/I- 


anithmetic logical operator 


>= alop 
alop ; 

= ANDIORI=/>/K/<>/</>=/=>/<=/-< 

NOT is not included here on purpose. 

operator 

= op 
op 

:= aoplalop: 


cra 
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arithmetic expression 
>= aexpr 


aexpr 
:= avar/real/integer 

(aexpr) 

If parentheses are nested more than 36 levels deep, the 7OUT OF MEMORY ERROR 

occurs. 

[+/—/NOT] aexpr 

Unary NOT appears here, along with unary + and —. 

aexpr Op aexpr 


subscript 


:= (aexpr [(, aexpr)]) 
The maximum number of dimensions is 89, although in practice this will be limited by the 


extent of memory available. aexpr must be positive, and in use it is converted to an integer. 


avar 


avar subscript 


aexpr 


avar subscript 


literal 
= [(character) ] 


string 
>= “[(character)] ’’ 
A string occupies 1 byte (8 bits) for its length, 2 bytes for its location pointer, and 1 byte for 
each character in the string. 
:= “[T(characte~] return 
This form of the string can appear only at the end of a line. 


null string 


aaa 


string variable name 
>= name$ 


string variable 
:= svar 


svar 


>= name$/name$ subscript 
The location pointer and adlebler name each occupy 2 bytes in memory. The length and each 


string character occupy one byte. 


string operator 
= sop 


sop 


string expression 
“= Sexor 


sexpr 
>= svar/string 
sexpr sop expr 


string logical operator 


>= slop 
slop 

2= =/>/>=/=>/</<=/=</<>/s< 
aexpr 

- = sexpr slop sexpr 
variable 

>= var 
var 

>= avar/svar 
expression 

>= expr 
expr 

>= expr/sexpr 


prompt character 


:= ] 


The right bracket (]) is displayed when BASE is ready to accept another command. 


Line numbers must be in the range 0 to 63999 or a ?SYNTAX ERROR message results. 


reset 
, == apress of the key marked “RESET” 
esc 
= a press of the key marked “ESC” 
return 
: = a press of the key marked “RETURN” 
ctrl 
‘= hold down the key marked “CTRL” 
line number 
>= linenum 
iinenum 
“= (digit) 
‘line 


while the following named key is pressed. 


linenum [(instruction:)] instruction return A line may have up to 239 characters. 


This 
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includes all spaces typed by the user, but does not include spaces added by BASE in for- 
matting the line. 


RULES FOR EVALUATING EXPRESSIONS 


Operators are listed vertically in order of execution, from the highest priority (parentheses) 
to the lowest priority (OR). Operators listed on the same line are of the same priority. 
Operators of the same priority in an expression are executed from left to right. 


(>) 
+ =«NOF array operators 


“7 
+ = 
> SAS Ce eS Se KS OS = 
AND 
OR 


CONVERSION OF TYPES 


When an integer and a real are both present in a calculation, all numbers are converted to 
reals before the calculation takes place. the results are converted to the-arithmetic type 
(integer or real) of the final variable to which they are assigned. Functions which are defined 
on a given arithmetic type will convert arguments of another type to the type for which they 
are defined. Strings and arithmetic types cannot be mixed. Each-can be converted to the 
other by functions provided for the purpose. 


~ 


4—3 THE STATEMENTS OF BASIC LANGUAGE 


4-3-1 


4-3-2 


ASC imm & def 


ASC (sexor) 


This function returns an ASCII code (not necessarily the lowest number) for the first 
character of /sexpr/. ASCII codes in the range 96 through 255 will generate characters on the 
BASE which repeat those in the range 0 through 95. However, although CHR$ (65) returns 
an A and CHR$ (193)-also returns an A, BASE does not recognize the two as the same 


character when using string logical operators. 


Ifa string is the argument, it must be enclosed in quotation marks, and quotation marks may 
‘not be included within the string. If type string is null, the message 


?ILLEGAL QUANTITY ERROR 


is given. 
COLOR imm & def 


COLOR = aexpr 


Sets the color for plotting in low resolution graphics mode. If /aexpr/ is a real, it is converted 
to arrinteger. The range-of values-for /aexpr/ is from 0 through 255; these are treated module 


16. 
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Color names and their associated numbers are 


0 black 4 dark green — 8 _ brown 12 green 
1 magenta 5 grey 9 orange’ 13 yellow 
2 drak blue 6 medium blue 10 grey 14 aqua 
3 purple 7 light blue 11. pink | 15 white 


COLOR is set to zero by the GR command. 
To find out the COLOR of a given point on the screen, use the SCRN command. 


When used in TEXT mode, COLOR is one factor in determining which character is placed on 
the screen by a PLOT instruction. \ 


If used while in High-resolution GR aphics mode, COLOR is ignored. 


4-3-3 CHR$ imm & def 
CHR4 (aexpr) 


A function that returns the ASCII character which corresponds to the value of aexpr. /aexpr/ 
must be between 0 and 255, inclusive, or the message 


?ILLEGAL QUANTITY ERROR 

appears. Reals are converted to integers. 
4-3-4 CALL imm & def 

CALL aexpr 


Causes execution of a machine-languge subroutine at the memory location whose decimal 
address is specified by /aexpr/. 


/aexpr/ must be in the range -65535 through 65535 or the message 

?7ILLEGAL QUANTITY EFFOR 

is dispalyed. In practice, /aexpr/ is usually limited to the range of addresses for which vaild 
memory devices exist, from 0 through the maximum value for HIMEM: in your computer. 


See HIMEM: and POKE for more details. 


Equivalent positive and negative addresses may be used interchangeably. For instance, 
“CALL —936” and ‘‘CALL 64600” are identical. - : 


4-3-5 CLEAR im & def 
CLEAR 


No parameters. Zeroes all variables, arrays and strings. Resets pointers and stacks. 


4-3-6 DEF def 
| FN imm & def 


DEF FN name (real avar) = aexprl 
FN name (aexpr 2) 


Allows user to define functions in a program. First the function FN name is defined using 
DEF. Once the program line DEFining the function has been executed, the function may be 
used in the form FN name (argument) where the argument aexpr 2 may be any arithmetic 
expression. The DEFinition’s aexprl may be only one program line in length; the defined FN 
name may be used wherever arithmetic functions may be used in BASE. 


Such functions may be reDEFined during the course of a program. The rules for using 
arithmetic variables still apply. In particular, the first two characters of name must be unique. 
When these lines 


10 DEF FN ABC(I) 
20 DEF FN ABT(I) 


COS(I) 
TAN(I) 


are executed, BASE recognizes the definition of FN AB function in line 10; in line 20, the 
FN AB function is redefined. ; 


In the DEF instruction, real avar is a dummy variable. when the user-defined function FN 
name is used later, it is called with an argument aexpr 2. This argument is substituted for real 
avar wherever it appears in the definition’s aexprl. aexprl may contain any number of 
variables real avar, and therefore corresponds to the argument variable. 


The DEFinition’s real avar need not appear in aexprl. In that case, when thé function is used 
later in the program, the function’s argument is ignored in evaluating aexprl. Even in this 
case, however, the function’s argument is evaluated itself, so it must be something legal. 

For instance: | 


100 DEF FN A(W) = 2* W+W 
110 PRINT FN A(23) 

120 DEF FN B(X) = 4+ 3 

130 G = FN B(23) 

140 PRINT G 

150 DEF FN A(Y) = FN B(Z) + Y 
160 PRINT FN A(G) 


RUN 

69 [ FN A(23) = 2*23 + 23 ] 

7 [ FN B(anything) = 7] 

14 [ new FN A(7) =7 +7 ] 

lf a deferred-execution DEF FN name statemer t is not executed prior to using FN name, the | 
?UNDEF’D FUNCTION ERROR 


message is displayed. 


User-defined string functions are not allowed. Functions defined using an integer name% for 
name or for real avar are not allowed. 
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When a.new function is defined by a DEF statement, 6 bytes in memory are used to store the 
pointer to the definition. 


4—3—7 DRAW imm & def 


DRAW aexpr1 AT aexpr 2. aexpr 3 
DRAW aexpr 1 


DRAW with the first option draws a shape in high-resolution graphics starting at the point 
whose x-coordinate is /aexpr 2/ and whose y-coordinate is /aexpr 3/. The shape drawn is the 
/aexpr 1/ th shape defintion in the shape table previously loaded using the SHLOAD 
command (or a shape table may be typed into the BASE memory in hexadecimal code, using 
the Monitor program). 


/aexpr 1/ must be in the range 0 through n, where n is the number (from O through 255) of 
shape definitions given in byte O of the shape table. /aexpr 2/ must be in the range O through 
278. /aexpr 3/ in the range O through 191. If any of these is exceeded, the message 


?7ILLEGAL QUANTITY ERROR 
will be displayed. 


The color, rotation and scale of the shape to be drawn must have been specified before 
DRAW is executed. 


The second option is similar to the first, but draws the specified shape starting at the last 
point plotted by the most recently executed HPLOT, DRAW, or XDRAW command. 


NOTE: 
If issued when there is no shape table in the computer, may cause the system to ‘‘hang."’ To 
recover, use reset ctrl C return May also draw random “‘shapes’’ all over the high-resolution 
graphics areas of memory. possibly destroying your program, even if you are not in graphics 
mode. 


4-3-8 DATA def only 
DATA [literal/string/real/integer] [(, [literal/sting/real/integer] )] 
This statement creates a list of elements which can be used by READ statements. In order of 
instruction line number, each DATA statement adds its elements to the list of elements built 


up by the programs’s previous (lower line number) DATA statements. 


The DATA statement does not have to precede the READ statement in:a program; DATA 
statements can appear anywhere throughout the program. . 


DATA elements which are READ ‘into arithmetic variables generally follow the same rules as 
for INPUT responses assigned to arithmetic variables. However, the colon cannot be included 
as a character in a numeric DATA element. 


If ctrl C is a DATA element, it does not stop the program, even when it is the first character 


of an element. With this exception, DATA elements which are READ into string variables 
follow the same rules as for INPUT responses assigned to string variables: 
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ce A A is I —— 


a 
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Either strings or literals may be used, or both. 
Spaces before the first character and following a string are always ignored. 


Any quotation mark that appears within a string causes the SYNTAX ERROR message, 
but all other characters are accepted as characters in that String, including the colon and 
the comma (but not including ctrl X and Ctrl M): 


If an element is a literal, then the quotation mark is accepted as a valid character any- 
where in the literal except as the first non-space character; the colon, the comma, ctrl X, 


and ctrl M are not accepted. 


See INPUT for more details. 


DATA elements may be any mixture of reals, integers, strings and literals. If the READ 
statement attempts to assign a DATA element that is a string or a literal to an arithmetic 


variable,- the 
?SYNTAX ERROR 


message is given for the appropriate DATA line. 


If the list of elements in a DATA statement contains a ‘non-existent’ element, then a zero 
(numeric) or the null string is returned for that element depending on the variable to which 
the element is assigned. A ‘’non-existent’’ element occurs in a DATA statement when any of 


the following is true: 


1) There is no non-space character. between DATA and return. 
2) Comma is the first non-space character following DATA. 

3) There is no non-space character between two commas. 

4) Comma ts the last non-space character before return. 


So when this statement is READ 
100 DATA,, 
it can return up to three elements consisting of zeros or null strings. 


When used in immediate execution mode, DATA does not cause a SYNTAX ERROR, but its 
data elements are not available to a READ statement. 


DIM imm &-def 


DIM var subscript [(,var subscript) ] 


When a DIM statement is executed, it sets aside space for the array with the name var. Two 
bytes in memory are used for storing an array variable name, two for the size of the array, 
one for the 'number of dimensions, and two for each dimension. As discussed below, the 
amount of space allocated for the elements of an array depends upon the type of array. 


Subscripts range from 0 to /subscript/. The number of elements in an n-dimensional array is 


(/subscript 1/+1) * (/subscript 2/+1) *. . . * (/subscriptn/+1). 


a 


E.g. DIM SHOW (4, 5, 3) sets aside 5*6*4 elements (120 elements). 
Typical elements are: 


SHOW (4, 4, 1) 
SHOW (0, 0, 2) 


and so on. \ 


The maximum number of dimensions for ‘an array is 88, even if each dimension can contaip 
only one. element: 


DIM A(O, 0,...0) where there are 89 zeros gives an 
?0UT OF MEMORY ERROR 
but DIM A(0, 0, . ... 0) where there are 88 zeros does not. 


In practice; however, the size of arrays is often limited much more by the amount ot memory 


available. Each integer array element occupies 2 bytes (16 bits) in memory. Each real array. 
element occupies 5 bytes (40 bits) in memory. String array variables use 3 bytes for each. 


element (one for lenght, two for a location pointer), stored as an integer array when the array 
is DiMensioned. As the stiings themselves are stored by the program, they occupy an 
additional one byte per character. 


If an array element‘is used in a program before that variable is DIMensioned. BASE assigns a 
maximum subscipt of 10 for each dimension in the element's subscript. 


Using a variable whose subscript is larger than the maximum designated, or which calls for a 
different number of dimensions than specified in a DIM statement, causes the 


'?BAD SUBSCRIPT ERROR 


message to appear. 


If the program DIMensions an array that has the same name as a previously DIMensioned 
array (even if DIMensioned by default usage), then the message 


?REDIM’D ARRAY ERROR 
appears. 


The individual strings in a string array are not dimensioned, but grown and shrink as 
necessary. The statement ; 


WARD$(5) = ‘““ABCDE” 
creates a string of length 5. The statement 
WARD§$(5) = ‘“” 


de-allocates the space allotted to the string WARD$(5). A string may contain a maximum of 
255 characters. 


Array elements are set to zero when RUN or CLEAR are executed. 


4-3-10 DEL imm & def 
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DEL linenum 1, linenum 2 


DEL deletes the range of lines from linenum1 to linenum2, inclusive. If linenum1 is not-an 
existing program line number, the next greater line number in the program is used in line of 
linenum1; if linenum2 is not an existing program line number, the next smaller progfam line 
numer is used. . 


If you don't follow the usual format, DEL’s performance varies as indicated below: 


syntax result 

DEL ?SYNTAX ERROR 
DEL ?SYNTAX ERROR 
DEL ,b ?SYNTAX ERROR 


DEL —a[,b] ?SYNTAX ERROR 
DEL 0,b ~° deletes line zero, regardless of the value of b. 
DEL 1,—b ignored, even if the program's smallest line number is zero. 


DEL a.—b 1SYNTAX ERROR if a is greater than the program's smallest line number, 
unless the program's smallest line number is zero and a is one. 


DEL a,—b ignored if a is not zero and the only. program line is line number zero. 
DEL a,—b ignored if a is not zero and if a:is less than or equal to the program's smallest’ 
| line number. 


DEL al[,] ignored. 
DEL a,b ignored if a is not zero and a is greater than b. 


When used in deferred execution, DEL works as described above, then halts execution 
CONT will not work in this situation. 


FLASH imm & def 
INVERSE imm & def 
NORMAL imm & def 


FLASH 
INVERSE 
NORMAL 


These three commands are used to set video output modes. They do not use parameters, and 
they do not affect the display of characters as you type them into the computer nor 
characters already on the screen. 
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FLASH sets the video mode to ‘‘flashing’’, so the output from the computer is alternately 
shown on the screen in white on black and then reversed to black on white. 


INVERSE sets the video mode so that the computer’s output prints as black letters on a 
white background. 


NORMAL sets the mode to the usual white letters on a black background, for both input 
and output. 


FOR imm & def: 
For real avar = aexpr1 To aexpr2 (STEP aexpr3) 


/avar/is set to/aexpr 1/, and the statement following the FOR are executed until a statement 


NEXT avar 
is encountered, where avar is the same name as appears in the FOR statement. Then /avar/ is 
incremented by /aexpr3/ defaults to 1). Next /avar/ is compared to /aexpr2/, and if /avar/ / 


aexpr2, execution proceeds with the statement following the NEXT. If /avar/<=/aexpr2/, 
execution proceeds from the statement following the FOR. 


If /aexpre/<O then operation is slightly different after /aexpr3/ is added to /avar/. If /avar/ 
</aexpr2), execution proceeds with the statement following the NEXT. If /avar/>=/aexpr2/ 
then execution proceeds from the statement following the FOR. 


The arithmetic expressions which form the parameters of the FOR loop may be reals, real 
variables, integers, or integer variables. However, real avar must be a real variable. An 
attempt to use an integer variable for real avar results in the 


?SYNTAX ERROR 


message. 


as /avar/ is incremented and compared to /aexpr2/ only at the bottom of the FOR... 
NEXT loop, the portion of the program inside the loop is always executed at least once. 


‘FOR. ... NEXT loops must not ‘‘cross’’ each other. If they do, the message 
?NEXT WITHOUT FOR ERROR 

will be printed. 

If FOR loops are nested more than 10 levels deep, the 

?0UT. OF MEMORY ERROR 


message is displayed. 


To run a FOR... NEXT loop in immediate-execution mode, the FOR statement and the 
NEXT statement should both be included in the same line (a line is up to 239 characters 


long). 


= Tan 


NOTE: 
If the letter A is used immediately prior to TO, do not allow a space between the T and 0. 


FOR I=BETA TO 56 is fine, but FOR I=BETA T.O 56 parses as FRO I=BET AT 056 and 
gets a 


?SYNTAX ERROK 

on execution. 

Each active FOR .. . NEXT loop uses 16 bytes in memory. 

4-—3-—13 GR imm & def 

GR 

No parameters. This command sets low-resolution GRaphics mode (40 by .40) for the 
screen, leaving four lines for text at the bottom. The screen is cleared to balc, and the cursor 
is moved to the text window. Can be converted to full-screen (40 by 48) graphics, after 
executing GR, with the command 

POKE —16302,0 

or the equivalent command 

POKE 49234,0 
- If GR follows a full-screen POKE command, mixed G Raphics-plus-text mode is reset. 

After a GR command, COLOR has been set to zero. 

NOTE: 

If the reserved word GR is used as the first characters of a variable name, the GR may be 
executed before you get the 

?SYNTAX ERROR 

message. Thus, executing the statement 

GRIN = 5 


leaves you with an unexpectedly darkened screen. 


NOTE: 
If issued while HGR is in effect, GR-behaves normally. However, if issued while HGR2 is in 
effect, GR clears its usual screenful of memory, but Jeaves you looking at page 2 of low- 
resolution graphics and text. To return to normal mode, simply type TEXT. In programs, 
use TEXT before switching form HGR2 to GR. 

4—3—14 GOTO imm & def 
GOTO linenum 


Branches to the line whose line number is linenum. If there is'no such line, or if linenum is 
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absent from the GOTO statement, then the message 
2UNDEF'D STATEMENT ERROR IN linenum 


is displayed, where linenum is the line number of the program line containing the GOTO 
statement. 


GOSUB imm & def 

GOSUB linenum 

The program branches to the indicated line. When a RETURN statement is executed, the 
program branches to the statement immediately following the most recently executed 
GOSUB. 

Each time a GOSUB is executed, the address of the following statement is stored on top 
of a ‘'stack’’ of these addresses, so the program can later find its way back. Each time a 
RETURN ora POP is executed, the top address in the RETURN “‘stack”’ is removed. 

If the indicated linenum does not correspond to an existing program line, the error message 
?UNDEF’D STATEMENT ERROR IN linenum 

is given, where linenum *-dicates the program line containing the GOSUB statement. The 
IN linenum 

portion of the message is omitted if GOSUB is used in direct execution mode. 

If GSOUBs are nested more than 25 levels deep, the message 

?0UT OF MEMORY ERROR 

is displayed. 

Each active GOSUB (one that has not RETURNed yet) uses 6 bytes of memory. 

GET def only | 

GET var 


Feiches a single character from the keyboard without displaying it on the screen and 
without requireing that the RETURN key be pressed. 


The behavior of GET avar has a few surprises: 
ctrl @ returns the null character. 


The result of GETting a left-arrow or ctrl H may also 
PRINT as if the null character were being returned. 


ctrl C is treated as any other character; it does not interrupt program execution. 


— 


Ti | 
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While BASE was not designed or intened to GET values for arithmetic variables, you may 
use 


GET avar 


subject to the following stringent limitations: 


NOTE: 
GETting a colon or a comma results in the 


?7EXTRA IGNORED 
message, followed by the return of a zero as the typed value. 


The plus sign, minus sing, ctr! @, E, space and the period all return a zero as the tvped 
value. 


Typing a return or non-numeric input causes*the 
?SYNTAX ERROR 


message to be displayed. 


With ONERR GOTO. . . RESUME, two consecutive GET errors will cause the system 
to hang until RESET is pressed. If GOTO is substituted for RESUME, all is well until 
the 43rd GET error (in any order), when the program jumps to the Monitor. To 
recover, use reset ctrl C return. 


Because of these limitations, it is recommended that serious programmers GET numbers 
using 


GET svar 


and convert the resulting string to a number using the VAL function. 
FRE imm & def 


FRE (expr) 


FRE returns the amount of memory (in bytes) still available to the user. You may 
sometimes wind up with more memory than you expected, since BASE stores duplicate 
strings only once. That is, if A$="‘PIPPIN’’ and B$="PIPPIN’’ then the string ‘‘PIPPHN”’ will 


be stored only once. 


If the number of free memory bytes exceeds 32767, FRE(expr) returns a negative number. 
Adding 65536 to this number gives you the actual number of free bytes of memory. 


FRE(expr) returns the number of bytes remaining below the string storage space and above 
the numeric array and string pointer array space. HIMEM: can be set as high as 65535, but if 
it is set beyond the highest RAM memory location in your BASE, FRE may return a rather 
meaningless number exceeding the memory capacity of the computer. (See HIMEM: and 
POKE for a discussion of memory limits.) When the contents of a string are changed during 
the course of a program, (e.g. A$ which equaled ‘‘cat’’ becomes A$="‘dog’’) BASE does not 
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eliminate ‘‘cat’’, but just opens new file for ‘‘dog’’. As a result, a lot of old characters slowly 

fill down from HIMEM: to the top of the array space. BASE will automatically ‘‘house- [ 
clean’’ when this old data runs into the free array space, but if you are using any of the free l 
space for machine language programs or hi 


gh-resolution page buffers, they may be 
clobbered. Using a statement of the form 


X = FRE(0) 
periodically within your program will force the house-cleaning to occur and ‘prevent such: | Ly 
events. 


Although expr is just used to hold the parentheses apart, it is evalusted, so it should not be LI 
something illegal.- 


4—3—18 HOME imm & def LI 
HOME 


No parameters. Moves cursor to upper left screen position within the scrolling window and 


Clears all text within the window. This command is identical to “GALL —936” and to “ESC 
@ return” 


4—3—19 HGR imm & def 


2 


No parameters. Sets high-resolution graphics mode (280 cy 160) for the screen, leaving four | | 
lines for text at the bottom. The screen i 


at full screen, but, only the 
bottom four text lines are visible below the graphics. The cu 
“window,” but may not be visible unless it is moved to.one of t 


he bottom 4 lines. { | 
HPLOT must be preceeded by HGR or HGR 2 to avoid clobbering lots of memory, | 
including your program and variables. ) ] 
/aexpr 1/ and /aexpr 3/ must be in the range U through 279, — | 
/aexpr 2/ and /aexpr 4/ must be in the range 0 through 191, 
/aexpr 1/ may be greater than, equal to, or ‘less than:/aexpr 3/. /aexpr 2/ may be greater | 
than, equal to, less than /aexpr 4/. ~ | ; 


- An attempt to plot a point whose coordinates exceed these limits causes the 


?ILLEGAL QUANTITY ERROR 


message. If the screen is in mixed hi 


gh-resolution graphics 
to plot points with y-coordinates in 


plus 4 lines of text, than attempts 
the range 160 through 


191 will have no visible effect. : 
4—3—20. HTAB imm & def f 
HTAB aexpr 


Assume the line in which.the cursor is located has 255 postions, 1 through 255. Regardless 
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of the text window width you may have set, positions 1 through 40 are on the current line, 
positions 41 through 80 é-e on the next line down, and so on. HTAB moves the position 
that is /aepre/ positions from the left edge of the current screen line. HTAB‘s moves are 


‘relative to the left margin of the text window, but independent of the line width. HTAB can 


move the cursor outside the text window, but only long enough to PRINT one character. To 
place the cursor in the leftmost position of the current line, use HTAB 1. 


HTAB 0 moves the cursor to.position 256. 

\f /aexpr/ is negative or greater than 255, the message 
?ILLEGAL QUANTITY ERROR 

is printed. 


Note that the structures of HTAB and VTAB are not parallel, in that HTABs beyond the 
right edge of the screen do not cause the 


?ILLEGAL QUANTITY ERROR 

message, but cause the cursor to jump to the 1ower line and tab (aexpr-1) MOD 40) + 1. 
HLIN imm & def 

HLIN aexpr 1, aexpr 2 AT aexpr 3 

Used in low-resolution GRaphics mode, HLIN draws a line froms (/aexpr 1/,./aexpr 3/) to 
(/aexpr 2/, /aexpr 3/). The color is determined by the most recently executed COLOR 


statement). 


/aexpr 1/ and /aexpr 2/ must be in the range 0 through 39, and /aexpr 3/ must be in the 
range O through 47, or the message 


?ILLEGAL QUANTITY ERROR 

appears. /aexpr 1/ may be greater than, equal to, or less than /aexpr.2/. 

If HLIN is used when the system is im TEXT mode, or in mixed GRaphics-plus-text mode 
with /aexpr 3/ in the range 40 through 47, then a line of characters will be placed where the 
line of graphic dots would have been plotted. (A character occupies the space of two 
low-resolution dots stacked vertically. 


The command has no visible effect when used in high-resolution graphics mode. 


Note that the ‘’H”’ in this command refers-to “horizontal” and not “high-resolution”. 
Except for HLIN and HTAB, the prefix ‘’H"’ refers to high-resolution instructions. - 


HIMEM: imm & def 
HiiMIM: aexpr 1 aexpr 2 AT aexpr 3 
Sets the address of the highest memory location available to a BASIC prog 1m, including 


variables. It is used to protect the area of memory above it for data, graphics of machine 
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language routines. 


/aexpr/ must be in the range —65535 through 65535, inclusive, to avoid the 


ILLEGAL QUANTITY ERROR 


message. However, programs may not execute reliably unless there is appropriate memory 
hardware at the locations specified by all addresses up to and including /aexpr/. 


Normally, BASE automatically sets HIMEM: to the highest memory address available on the 
user’s computer, when BASE is first invoked. 


The current value of HIMEM: is stored in memory locations 116 and 115 (decimal). To see 
the current value of HIMEM:, type 


PRINT PEEK(116)*256 + PEEK(115) 


If HIMEM: sets a highest memory address which is lower than that set by LOMEM.:, or 
which does not leave enough memory available for the program to run, the 


?0UT OF MEMORY ERROR 
is given. 


/aexpr/ may be in the range O increasing to 65535, or in the equivalent range —65535 
increasing to —1. Equivalent positive and negative values may be used interchangeably. 


HIMEMWi: is not reset by CLEAR, RUN, NEW, DEL, changing or adding a program line, or 
reset. HIMEM: is reset by reset ctrl B return, which also errases any stored porgram. 


IF imm & def 


IF expr THEN instruction [(: insttuction) ] 
IF expr THEN [GOTO] linenum 
IF expr [THEN] GOTO lineunum 


If expr is an arithmetic expression whose value is not zero (and whose absolute value is 
greater than about 2.93873E—39), /expr/ is considered to be true, and any instruction(s) 
following THEN are executed. 


If expr is an arithmetic expression whose value is zero (or whose absolute value is less than 
about 2.9387E—39), any instructions following THEN are ignored, and execution passes on 
to the instruction in the next numbered line of the program. 


When the IF statement occurs in an immediate execution program, if /expr/ is zero, BASE 
will ignore the entire remainder of the program. 


If expr is an arithmetic expression involving string expressions and string logical operators, 
expr is evaluated by comparing the alphabetic ranking of the string expressions as 
determined by the ASCII codes for the characters involved. 


Statements of the form 
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IF expr THEN 

are valid: no error message is printed. 

A THEN without a corresponding IF or an IF without a THEN will cause the message 
?SYNTAX ERROR 

to be displayed. 

BASE was not designed or intended to allow the IF statement’s expr to be a string 
expression, but string variables and strings may be used as expr under the following stringent 
conditions. 

If expr is a string expression of any kind, the /expr/ is non-zero, even if expr is a string 
variable which has been assigned no value of ‘’0” or the null string, ‘’ ‘’. However the literal 
null string, as in 

le! THEN «s+ 

evaluates as zero. 

IF STRING THEN ... 

When executed more than two or three times in a given program, causes the message 
?FORMULA TOO COMPLEX ERROR 


to be printed. 


If expr is a string variable and the previous statement assigned the null string to any string 
variable, then /expr/ evaluates as zero. For instance, the program 


120 IF A$ THEN PRINT “A$” 

130 IF B$ THEN PRINT “B$” 

140 IF X$ THEN PRINT “X$” 

when RUN, prints 

A$ 

B$ 

X$ 

because strings A$, B$ and X$ evaluate as non-zero. However, adding the line 


100 @S = “" 


causes all 3 strings to evaluate as zero, and no output is printed. Deleting line *00, or adding 
almost any line 110, such as 


110 F = 3 


causes all 3 strings to evaluate as non-zero again. 
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Before THEN, the letter A causes parsing problems: 
IF BETA THEN 230 
parses to 
IF BET AT HEN230 
which generates a 
?SYNTAX ERROR 
massage on execution. 
These are equivalent: 
IF A=3 THEN 160 
IF A=3 GOTO 160 
IF A=3 THEN GOTO 160 
4-3-24 IN# imm & def 
IN# aexpr 
Selects input from slot /aexpr/. Used to specify which peripheral will be providing input for 
subsequent INPUT statements. Peripherals may be in slots 1 through 7, as indicated by 


/aexpr/. 


IN# O indicates that subsequent input will be from the keyboard instead of the peripheral. 
Slot 0 is not addressable from BASE for use with a peripheral device. 


If no peripheral is in slot /aexpr/, the system will hang. To recover, use reset ctr! C return. 
If. /aexpr/ is less than O or greater than 255, the message 
?ILLEGAL QUANTITY ERROR 

is displayed 

If /aexpr/ is in the range 8 through 255, BASE is altered in unpredictable ways. 

For similar transfer of output, see PR#. 


4—3- 25 INPUT def 


. “INPUT [string;] var [!, var) ] 


If tne optional string is left out, INPUT prints a question mark and waits for the user to ~ 


type a number (if var is an arithmetic variable) or characters (if var is a string variable). The 
value of this number or string is put into var. 


When the string is present, it is printed exactly as specified; no question mark, spaces, or 


other punctuation are printed after the string. Note that only one optional string may be 
used. It m 
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used. It must appear directly after “INPUT” and be followed by a semi-colon. 


If the response is a literal, then quotation marks are accepted as characters in any part of the 
literal except the first non-space character. Spaces following the last character are accepted 
as part of the literal: However, the comma and colon (and ctrl X and ctrl M) are not 
accepted as characters in the literal. | : 


If the user simply presses the RETURN.key when a numeric response is expected, the 
message 


?REENTER 


is printed and the INPUT instruction is re-executed. If the RETURN key alone is typed 


when a string response is expected, the response is interpreted as the null string and program 
execution continues. 


Successive variables get successively typed values. String variables and arithmetic variables 
may be mixed in the same INPUT statement, but the user’s responses must each be of the 
appropriate type. The typed responses may be separated by commas or returns. As a result, 
if a user types commas in a response that does not begin with a quotation mark, the commas 
are interpreted as response separators. This is true even when only one response is expected. 


If a colon is typed in an INPUT response that does not: begin with a quotation mark, all 
characters typed subsequently are ignored. After a colon, commas are also ignored, so the 
start of another response must be signaled by a return. 

If a return is encountered before all the var’s have been assigned responses, two question 
marks are printed to indicate that an, additional response is expected. When a return is 
encountered, if the response contains more response fields than the statement expected, or 
if a colon exists in the final expected response (but not within a strint), then the message 
?7EXTRA IGNORED 


is printed and program execution continues. 


If a colon or a comma is the first character of an INPUT response, the response is evaluated 
as zero or as the null string. 


Note that in the INPUT command the optional string must be followed by a semi-colon but 
variables must be separated by commas. 


ctrl C can interrupt an INPUT statement, but only if it is the first character typed. The 
program halts when return is typed..An attempt to CONTinue execution after such a halt 
results in the 

?SYNTAX ERROR 

message. ctrl U is treated as any other character if it is not the first character typed. 


Trying to use the INPUT command in direct execution mode causes the 


?7ILLEGAL DIRECT ERROR . 
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message. 


4-3—26 LOAD imm & def 
SAVE imm & def 


LOAD 
SAVE 


These LOAD a program from a cassette tape and SAVE a program on a cassette tape, 
respectively. There is no prompting message or other signal issued by these commands; the 
user must have the cassette tape recorder running in the proper mode (paly or record) when 
the command is executed. LOAD and SAVE do not verify that the recorder is in the proper 
mode or even that the recorder is present. Both commands sound a “beep’’ to signal the 
beginning and the end of recordings. 


Program execution continues after a SAVE Operation, but a LOAD deletes the current 
program when it begins reading new information from the cassette tape. 


Only reset can interrupt a LOAD or a SAVE. 


If the reserved word LOAD or SAVE is used as the first characters of a varible name, the 
reserved-word command may be executed before any 


?SYNTAX ERROR 
message is given. The statement 


SAVERING = 5 


causes BASE to try SAVEing the current program. You can wait for the second “beep” (and . 


the ?SYNTAX ERROR message) or press reset. ; 

The statement 

LOADTOJOY = 47 

hangs the system, while BASE deletes the current program and waits indefinitely. for a 
program from the cassette recorder. Only by pressing reset can you regain control of the’ 
computer. 


4—3-—27 LET imm & def 


[LET] avar [subscript] = aexpr 
[LET] svar [subscript] =sexpr 


The variable name on the left is assigned the value of the string or expression on the right. 
The LET is optional: 


LET A=2 
and 


=2 
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are equivalent. 
The message 
?TYPE MISMATCH ERROR | 


is displayed if you try to give 
1) astring variable name to an arithmetic expression, or ° 


-b) astring variable name to a literal, or 


c) an arithmetic variable name to a string expression. 


If you try to give an arithmetic variable name to a literal, BASE attempts to parse the litera 
as an arithmetic expression. 


LEN imm & def 

LEN (sexpr) 

This function returns the number of characters in a string, between O and 255. If the 
argument is a concatenation of strings whose combined length is greater than 255, the 
message 

?STRING TOO LONG ERROR 

is given. 

LEFT$ imm & def 

LEFT$ (sexpr, aexpr) 

This function returns the first (leftmost) /aexpr/ characters of /sexpr/: 

No part of this ccommand can be omitted. If /aexpr/<1 or /aexpr/>255 then the message 
ILLEGAL QUANTITY ERROR 

is displayed. If /aexpr/ is a real, it is converted to an integer. 


If /aexpr/ > LEN(sexpr), only the characters which consittute the string are returned. Any 
extra positions are ignored. 


If ‘’$’’ is omitted from the command name, BASE treats LEFT as an arithmetic variable 
name and the message. 


?TYPE MISMATCH ERROR 
is displayed. 

LOMEM: imm & def 
LOMEM: -aexpr 


Sets the address of the lowest memory location available to a BASIC program. This is 
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usually the address of the starting memory location for the first BASIC variable. Normally, 
BASE automatically sets LOMEM: to the end of the current program, before executing the 
program. This command allows potection of availables from high-resolution graphics in 
computers with large amounts of memory. 

/aexpy/ must be in the range —65535 through 65535, inclusive, to avoid the 

?ILLEGAL QUANTITY ERROR 

message. 

H@wever if LOMEM: is set higher than the current value of HIMEM:, the message 
?7ILLEGAL QUANTITY ERROR 


is dispalyed. This means that /aexpr/ must be lower than the maximum value that can be set 
by HIMEM: (see HIMEM: for a discussion of its maximum value.) 


If LOMEM: is set lower than the address of the highest memory location occupied by the 
current operating system (plus any current stored program). the 


?O0UT OF MEMORY ERROR 


message is again displayed. This imposes an absolute lower limit on /aexpr/ of about 2051 
for firtware BASE. 


LOMEM: is reset by NEW, DEL, and by adding or changing a program line. 
LOMEM: is reset by reset ctrl B, which also deletes any stored program. It is not reset by 
RUN, reset ctrl C return or reset return. 


The current value of LOMEM: is stored in memory locations 106 and 105 (decimal). To see 
the current value of LOMEM:, type 


PRINT PEEK(106)*256 + PEEK (105) 

Once set, unless it is first reset by one of the above commands, LOMEM: can be set to a new 
value only if the new value is higher (in memory) than the old value. An attempt to set a 
lower LOMEM: than the value still in effect gives the 

2?0UT OF MEMORY ERROR 


message. 


Changing LOMEM: during the course of a program may cause certain stacks or portions of 
the program to be unavailable, so that the program will not continue to execute properly. 


Equivalent positive and negative addresses may be used interchangeably. - 
LIST imm & def 


LIST [linenum1] [— linenum2] 
LIST [linenum1] [, linenum2] 
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If neither linenum1 nor |'nenum2 is present, with or without a delimiter, the entire program 
is displayed on the screen. If linenum1 is present without a delimiter, or if linenum1 = 
linenum2, then just the just the line numbered linenum1 is displayed. If linenum1 and a 
delimiter are present, then the program is listed from the line numbered linenum1 through 
the end. If a delimiter and linenum2 are present, then the program is listed from the 
beginning through the line numbered linenum2. If linenum1, a delimiter and linenum2 are 
all present, then the program is listed from the line numbered linenum1 through the line 
numbered linenum2, inclusive. 


When more than one line is to be listed, if the line numbered linenum1 in the LIST 
statement does not appear in the program, the LIST command will use the next greater line 
number that does appear in the program. if the line program. 


These all LIST the entire program: 

LIST 0 LIST [,/—] 0 LIST 0 [,/1] 0 

List linenum. 0 

lists from the line with line number linenum through the end of the program. 

LIST, Q 

lists the entire program, then gives the 

?SYNTAX ERROR 

message. 

BASE “‘tokenizes’.. your program lines before storing the, removing unnecessary spaces in 
the process. When LISTing, BASE “‘reconstitutes’’ the tokenized program lines. adding 
spaces according to its own rules. For example, 

10 C=+5/-6:B=-—5 

becomes 

10 C=+5/-6:B=-5 

When LISTed. 

List uses a variable line width and various indentations. This can be a problem when you are 


trying to edit or copy a LISTed instruction. To force LIST to abandon formatting with 
extra spaces, clear the screen and reduce the text window to width 33 (maximum): 


HOME 
POKE 33,33 


BASE truncates a line to 239 characters, then LIST adds spaces liberally. So you can enter 
many extra characters by leaving out spaces when typing -- LIST adds them back. An 
attempt to copy your expanded statement from the screen results in truncation to 239 
characters again, including the spaces added by LIST. 


ADT 


4-—3-—31 


LISTing is aborted by ctrl C: 
MID$ imm / def 
MID$ (sexpr, aexpr1 [, aexpr2] ) 


MID$ called with two arguments returns the substring starting at the /aexpr1/th character of 
/sexpr/, and proceeding through the last character of /sexpr/. 


PRINT MID$ (‘‘BASE64”, 3) | 
SE64 


MID$(sexpr, aexpr) = RIGHT$ (sexpr, LEN(sexpr) + 1 — /aexpr/) 


MID$ called with three arguments returns /aexpr2/ characters of /sexpr/, beginning with the 
/aexpr1/ the character and proceeding to the right. 


PRINT MID$ (‘‘BASE”, 3, 5) 
SESOF 


lf /aexpr1/ > LEN (sexpr), then MID$ returns a null string. If /aexpr1/ + /aexprt/ exceeds 
the length of /sexpr/ (or 255, the maximum length of any string), any extra is ignored 
MID$(A$, 255, 255) returns one character if LEN(A$) = 255, otherwise the null string is 
returned. 


If either /aexpr1/| or /aexpr2/ are outside the range 1 through 255, inclusive, then the 
message . 


?7ILLEGAL QUANTITY ERROR 
is displayed. 


If the $ is omitted from the command name, BASE treats MID as an arithmetic variable 
name and the message 


?TYPE MISMATCH ERROR 
is displayed. 
NEXT imm & def 


NEXT [avar] 
NEXT avar [(, avar)] 


Forms the bottom of a FOR. . .NEXT loop. When a NEXT is encountered, the program 
either ignores it or branches to the statement following the corresponding FOR, depending 
on the conditions explained in the discussion of the FOR statement. 


Multiple avars must be specified in the proper order so FOR. . .NEXT loops are nested 
inside each other and do not ‘’cross over.”’ INcorrectly ordered avars will caused the message 


?NEXT WITHOUT FOR ERROR 
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to be printed. 
A NEXT statement in which no variable name is specified defaults to the most recently 
entered FOR-loop that is still in effect. If no FOR statement with the same variable name is 


in effect, or if no FOR statement of any name is in effect when a nameless NEXT is 
encountered, the message 


?NEXT WITHOUT FOR ERROR | 

is printed. 

NEXT without avar executes more rapidly than does NEXT avar. 

In immediate-execution mode, the FOR statement and its corresponding NEXT statement 


should both be executed in the same line. If a deferred-execution FOR statement is still in 
effect, an immediate-execution NEXT statement can cause a jump to the deferred-execution 


‘program, where appropriate. However, if the FOR statement was executed in immediate 


execution, a NEXT statement in a different immediate-execution line will cause the 


?SYNTAX ERROR 


unless there are no intervening lines and the NEXT stands alone and nameless: 


]FOR I= 1T0O5: PRINT I 
; , 
]NEXT 

2 

|NEXT 

3 


JNEXT I 
?SYNTAX ERROR IN xxxx (xxxx is some line number); 


NFW imm & def 
NEW 
No parameters. Deletes current program and all variables. 


ON...GOTO def 
on. ..GOSUB def 


On aexpr GOTO linenum ([, linenum] } 
ON aexpr GOSUB linenum ([, linenum] ) 


S|) ee GOTO branches to the line number specified by the /aexpr/ the item in the list of 
linenums after the GOTO. ON. . .GOSUB works in-a similar fashion, but a GOSUB rather 
than a GOTO is executed. 


If /aexpr/ is O or greater than the number of listed alternate linenums but less than 256, 
then program execution proceeds to the next statement. 


/aexpr1/ must be in the range O to 255 to avaid the message 
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?ILLEGAL QUANTITY ERROR 

ONERR GOTO def only 

ONERR GOTO linenum 

When an error occurs, ONERR GOTO may be used to avoid having an error message printed 
and execution halted. The command sets a flag that caused an unconditional jump (if an 
error occurs later in the program) to the program line indicated by linenum. POKE 216, 0 


resets the error-detection flag so that normal error messages will be printed. 


The ONERR GOTO statement must be executed before the occurance of an error to avoid 
program interruption. 


When an error occurs in a program, the code for the type of error is stored in decimal 
memory location 222. To see which error was encountered, PRINT PEED(222). 


Code Error Message Code Error Message 
O NEXT without FOR 120  Redimensioned Array 
16 Syntax 133 Division by Zero 
22 RETURNwithoutGOSUB 163 Type Mismatch 
42 OutofDATA 176 ~=String Too Long 
53 Illegal Quantity 191 Formula Too Complex 
69 Overflow 224 Undefined Function 
77 ~Out of Memory 254 Bad Response to INPUT Statement 
90  Underfined Statement 255 Ctrl C Interrupt Attempted 


107 ‘Bad Subscript 


NOTE- 

Care must be taken when handling errors that occur within FOR. .. NEXT loops or between 
GOSUB and RETURN, as the pointers and RETURN stacks disturbed. The error-handling 
routine must restart the loop, returning to the FOR or GOSUB statement, not the NEXT or 
RETURN statement. After error handling, a return to a NEXT or a RETURN will cause the 
appropriate message: . 


?NEXT WITHOUT FOR ERROR or WITHOUT GOSUB ERROR 


When ONERR-_ GOTO is used with RESUME to handle errors in a GET statement, the 
‘ program will “‘hang’’ if there are two consecutive GET errors without an intervening 
successful GET. To escape, use reset ctrl C return. If GOTO ends the error-handling routine, 
everything works fine 


NOTE: 

When used in TRACE mode or in a program containing a PRINT statement, ONERR causes 
a jump to the Monitor after 43 errors are encountered. Where these errors are generated by 
an INPUT statement, everything works fine if RESUME is used; but if GOTO ends the 
error-handling routine, the 87th INPUT error causes a jump to the Monitor. 


If you are bothered by any of the problems just discussed, execute a CALL to the following 
assembly-language subroutine as part of your error-handling routine. 
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In the Monitor, enter Hex data: 68 A8 68 A6 DF 9A 48 98 48 60 
or in BASIC, enter Decimal data: 104 168 104 166 223 154 72 152 72 96 


For example, in BASE you could POKE the decimal numbers into locations 768 through 
777. Then you would use CALL 768 in your error-handling routine. 


PDL imm & def 
PDL (aexpr) 


This function returns the current value, from 0 to 255, of the game control specified by 
/aexpr/, if /aexpr/ is in the range 0 throug 3. The game control is a resistance variable from 
0 to 150K ohms. 


If two game controls are read in consecutive PDL instructions, the reading from the second 
game control may be affected by the reading from the first. To obtain more accurate 
readings, allow several program linese between PDL instructions, or place a short delay loop 
(FOR I=1 TO 10: NEXT |) between PDL instructions. 


‘If /aexpr/ is negative or greater than 225, the 


?7ILLEGAL QUANTITY ERROR 

message is given. 

If /aexpr/ is in the range 4 through. 255, the PDL function returns a rather unpredictable 
number from 0 to 255, and may cause various side effects, some of which may disturb 


program exection. 


For instance, if /aexpr/ is in the range 204 to 219, use of the PDI functions is frequently and 
rather randomly accompanied by a “‘click’’ from the computer's speaker. 


If N is in the range 236 through 239, PDL (N) may result in a 

POKE —16540 + N, 0 

so that PDL(236) may set GRaphics mode, PDL(237) can set TEXT mode. 

In addition to reading the settings of 4 variable game controls using PDL, BASE can read the 


state of 3 game buttons (on-off switches) using various PEEK commands, and can turn on 
and off 4 game read-outs (TTL switches) using various POKE commands (see Appendix J). 


POS imm & def 

POS (expr) 

Returns the current horizontal position of the cursor on the screen e left hand 
margin of the text window. At the left margin, 0 is returned. Althou ,' just there to 


hold the parentheses apart, it is evaluated anyway, so it must not be illegal. Anything which 
can be interpreted as a number, a string or a variable name may be used for expr. If expr is 
a set of characters which cannot be a variable name, the characters must be enclosed in 
quotation marks. 
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Note that for HTAB and TAB positions are numbered from 1, but for POS and SPC they're 
numbered form 0. Therefore 


PRINT TAB (23); POS(O) 

causes 22 to be printed, while 

PRINT SPC(23; POS(0) 

causes 23 to be printed. 

PLOT imm & def. 

PLOT aexpr1, expr2 

In low-resolution graphics mode, this command siaes a dot with x-coodinate /aexpr1/ and 
y-coordinate /aexpr2/. The color of the dot is determined by the most recently executed 


COLOR statement (COLOR=0 if not previously specified). 


/aexpr1/must be in the range 0 throug 39, and /aexpr2/ must be in the range 0 through 47 
or the message 


?7ILLEGAL QUANTITY ERROR 

appears. 

An attempt or PLOT while the system is in TEXT mode, or in mixed G Raphics-plus-text 
mode with /aexpr2/ in the range 40 to 47, will result in a character being placed where the 
colored dot would have apperared. (A character occupies the space of two low-resolution 
graphics dots stacked vertically.) 

The command has no visible effect when used in HGR 2 High-resoiution graphics mode, 
even if preceded by a GR command, as the screen is not “looking at’’ the low-resolution 
graphics portion (pare one) of memory. 

The origin (0, O) for all graphics is in the upper left corner of the screen. 

POP imm & def 

POP 

There are no parameters or options associated with POP. A POP has the effect of a 
RETURN without the branch. The next RETURN encountered, instead of branching to one 
statement beyond the most recently executed GOSUB, will branch to one statement beyond 
the second most recently executed GOSUB. It is called a ‘‘POP’’ since it pops one address 
off the top of the “’stack’’ of RETURN addresses. 

If POP is executed before GOSUB has been encountered, then the message 


?RETURN WITHOUT GOSUB ERROR 


is displayed because there are no return addresses on the stack. 
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4-3-37 PR# imm & def 
PR# aexpr 
PR# transfers output to slot /aexpr/, where /aexpr/ must be in the range 1 to 7, inclusive. 
PR# returns output to the TV sehecki not to slot 0. 


If no peripheral is in the specified slot, the system will hang. To recover, use reset ctrl B 
return. 


If /aexpr/ is less than O or greater than 255, the message 
?7ILLEGAL QUANTITY ERROR 
is displayed. 
lf /aexpr/ is in the range 8 through 255, BASE is altered in unpredicable ways. 
For similar transfer of input, see IN#. 
4-3-—38 PEEK imm & def 
PEEK (aexpr) 
Returnes the contentes, in decimal, of the byte at address /aexpr/. 
POKE imm & def 
POKE aexpr1, aexp2 
POKE stores an eight bit quantity, the binary equivalent of the decimal Value /aexpr2/, into 
the locaton whose address is given by &aexpr1/. The range of /aexpr2/ must be from 0 
through 255; that of /aexpr1/ must be from —65535 through 65535. Reals are converted to 
integers before execution. Out of range values cause the message 
?ILLEGAL QUANTITY ERROR | 
to be printed. 
/aexpr2/ will be successfully stored only if the appropriate receiving hardware (memory, or a 
suitable output device) is present at the address specified by /aexpr1/: /aexpr2/ will not be 


successfully stored at non-receptive addresses such as the Monitor ROMs or unused 
Input/Output ports. 


Ingeneral, this means that /aexpr1/ will be in the range. 0 through max, where max is 
determined by the amount of memory in the computer. 


Many memory locations contain information which is necessary to the functioning of 
computer system. A POKE into these locations may alter the operation of the system or of 
your program, or it may clobber BASE. 


4--3-39 PRINT imm & def 
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PRINT [(expr) [(/; ((expr)])]] L/:] 
PRINT (;) 
PRINT /,) 


The question mark (?) may be used as an abbreviation for PRINT: it LISTs as PRINT. 


Without any options, PRINT causes line feed and return to be executed on the screen. When 
options are exercised, the values of the list of the specified expressions are printed. If 
neither a comma nor a semi-colon ends the list, a line feed and return are executed following 
the last item printed. If an item on the list is followed by a comma, then the first character 
of the-next item to be printed will appear in the first position of the next available tab field. 


The first tab field comprises the leftmost 16 printing positions in the text window, positions 
1 through 16. The second tab field occupies the next 16 positions (17 through 32), and is 
available for tab-field printing only if nothing is printed in position 16. The third tab field 
consists of the remaining 8 printing positions (33 through 40), and is available only if 
nothing is printed in positions 24 through 32. 


The PRINT tab field 3.does not function properly if the text window is set to less than 33 
_ positions wide; the first character may be printed outside the text window HTAB can also 
cause PRINT to dispaly a first character outside the text-window. 


If an item on the list is followed by a semi-colon, then the next items is concatenated: it is 
printed directly afterward with no intervening spaces. 


Items listed without intervening commas or semi-colons are concatenated if the items can 
be parsed without syntax problems. This is best illustrated by examples: 


A=1 : B=2 : C=3 :C(4=5 -.C=7 


PRINT 1/3(2*4)51, : print 1(A)2(B)3C(4)C5 
333333333851 1122357 

PRINT 3.4.5.6 : PRINT A. -“B. “C.4 
3.4.5.60 | 10B.3.4 


PRINT works very hard to figure out what you want, If it can't interpret a period as a 
decimal point, it treats it as the number 0, as illustrated in the examples. 


PRINT followed by a list of semi-colons does nothing more than PRINT alone, but it is 
legal. PRINT followed by a list of commas spaces one tab field per comma, up to a limit of 
239 characters per instruction. 

PRINT A$ +B$ 

gives a 

?STRING TOO LONG ERROR 

if the length of the concatenated string is greater than 255. However, you can print the 


apparent concatenation using 
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PRINT A$ B$ 

without worrying about its length. 
ROT im & def 

ROT = aexpr 


Sets angular rotation for shape to be drawn by DRAW or SDRAW. The amount of rotation 
is specified by /aexpr/, which must be between 0 to 255. 


ROT=0 will cause the shape to be DRAWn oriented just as it was defined, ROT=16 will 
cause the shape to be DRAW)n rotated 90 degrees clockwise, ROT=32 will cause the shape to 
be DRAWn rotated 180 degrees clockwise, etc. The process repeats starting at ROT=64. 
For SCALE=1, only 4 rotation values are recognized (0, 16, 32, 48); for SCALE=2, 8 
rotations are recognized, etc. Unrecognized rotation values will cause the shape to be 
DRAW)nh with the orientation of the next smaller (usually) recognized rotation. 


ROT parses as a reserved word only if the next non-space character is the replacement sign 


(=). 

RETURN imm & def 

RETURN 

There are no parameters or options in this command. This is a branch to the staten ent that 
immediately follows the most recently executed GOSUB. The address of the statement 


branched to is the top one on the RETURN “‘stack’’ (see GOSUB and POP). 


If a program encounters RETURN statements once more than it has encountered GOSUB 
statements, the message 


?RETURN WITHOUT GOSUB ERROR 

is presented. 

RIGHTS imm def 

RIGHT$ (sexpr, aexpr) 

This function returns the last (rightomost) /aexpr/ characters of /aexpr/: 


PRINT RIGHT$ (‘“‘BASE” + “WARE”, 8) 
SOFTWARE 


No part of this command may be omitted. If /aexpr/ > = LEN (sexpr) then RIGHTS returns 
the entire string. The message : 


?7ILLEGAL QUANTITY ERROR 
is displayed it /aexpr/ < 1 or /aexpe/ >255. 


If the “$" is omitted from the command name. BASE treats RIGHT as an arithmetic 
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variable name and the message 
?TYPE MISMATCH ERROR 
is displayed. 

RESUME def 

RESUME 


When used at the end of an error handling routine, causes the program to resume execution 
at the beginning of the statement in which an error occurred. 


If RESUME is encountered before an error occurs, the 
?SYNTAX ERROR IN 65278 


message may be given, or other strange events may transpire. Usually, your program will be 
stopped or it will “hang.” 


If an error occurs in an error handling routine, the use of RESUME will place the program in 
an infinite loop. Use reset ctrl B. return to escape. 


In immediate-execution mode, may cause the system to “‘hang,”” may cause a SYNTAX 
ERROR, or may begin executing an existing or even a deleted program 


READ imm & def 

READ var [(, var)] 

When the first READ statement is executed in a program, its first variable takes on the value 
of the first element in the DATA list (the DATA list consists of all the elements from all the 
DATA statements in the stored program). The second variable (if there is one) takes on the 
vaule of the second element in the DATA list, and so on. When the READ statement 
finishes execution, it leaves a data list pointer after the last element of data used. The next 
READ statement executed (if any) begins using the data list: from the position of the 
pointer Either RUN or RESTORE sets the pointer to the first element in the DATA list. 

An attempt to READ more data than the data list contains produces the message: 

?0UT OF DATA ERROR IN linenum 


where linenum is the line number of the READ statement which asked for additional * 
DATA. 


In immediate mode, you can only READ elements from DATA statements which exist as 
lines in a currently stored program, The elements of DATA in a stored program can be 
READ even if the stored program has not been RUN. If no DATA statement has been 
stored program has not been RUN. If no DATA statement has been stored, the message 
?70UT OF DATA ERROR 


is displayed. Executing a program in immediate mode does not set the data list pointer to 
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the first element in the DATA list. 
Extra data left unread is OK. 
RESTORE im def 


RESTORE has no parameters or options. This statement merely moves the data list pointer 
(see the READ and DATA statement) back to the beginning of the data list. 


RUN imm & def 

RUN [linenum] 

Clears all variables, pointers, and stacks and begins execution at the line number indicated 
by linenum. If linenum is not indicated, RUN begins at the lowest numbered line in the 


program, or returns control to the user if there is no program in memory. 


In deferred execution mode, if linenum is given.but there is no such line in the program, or 
if linenum is negative, then the message 


?UNDEF'D STATEMENT ERROR 

appears. If linenum is greater than 63999, the message 

?SYNTAX ERROR 

appears. You are not told in which line the error occured. 

In immediate execution mode, on the other hand, these two messages become 
?UNDEF’D STATEMENT ERROR IN xxxx . 

and 

?SYNTAX ERROR IN xxxx 

Where xxxx canbe various line numbers, usually above.65000.. 


If Run is used in an immediate-execution porgram, any subsequent portion. of the 
immediate-execution program is not executed. 


REM imm & def 
REM (character/"’) 
This serves to allow text of any sort to be inserted in a program. All characters, including 
statement separators and blanks may be included. Their usual meaninas are ignored. AREM 


is terminated only by return. 


When REMS are listed, BASE inserts an extra space after REM. no matter how many spaces 
were typed after REM by the user. 
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SPEED imm & def 
SPEED = aexpr 


Sets speed at which characters are to be sent to the screen or other input/output devices. 
The slowest speed is 0; the fastest speed is 255. Out of range values will cause the message 


?7ILLEGAL QUANTITY ERROR 
to be displayed. 


STOP imm & def 
END imm & def 
ctrl C imm only 
reset imm only 
CONT imm & def 


STOP 

END 

ctrl C 

reset ‘ 
CONT 


STOP causes a program to cease execution, and returns control of the computer to beuser. 
It prints the message 


BREAK IN linenum 
where linenum is the line number of the statement which executed the STOP. 


END causes a program to cease execution, and returns control to the user. No message is 
printed. 


ctrl C has an effect equivalent to the insertion of a STOP statement immediately after the 
statement that is currently being executed. ctrl C can be used to interrupt a LISTing. It can 
also be used to interrupt an INPUT, but only if it is the first character entered. The INPUT 
is not interrupted until return is pressed. 


reset stops any BASE program or command unconditionally and immediately. The program 
is not lost, but some program pointers and stacks are cleared. This command leaves you in 
the system monitor program, as indicated by the monitor’s prompt character §*). 

If program execution has been halted STOP, END or ctrl C, the CONT command causes 
execution to resume at the next instruction -- not the next line number. Nothing is cleared. 
If there is no halted program, then CONT has no effect. After reset ctr! C return the 
program may not CONTinue to execute properly, since some program pointers and stacks 
will have been cleared. 

If an INPUT statement is halted by ctrl C, an attempt to CONTinue execution results in a 
?SYNTAX ERROR IN linenum 


message, where linenum is the line number of the line containing the INPUT statement. 
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Executing CONT will result in the 
?CAN’T CONTINUE ERROR 


Message if, after the program's execution halt, the user 
a) modifies or deletes any program line. 
b) attempts any opertion that results in an error message. 


However, program variables can be arranged using immediate-execution commands, as long 
as no error messages are incurred. 


If DEL is used in a deferred execution statement, the specified lines are deleted and. then 
program execution halts. An attempt to use CONT under these circumstances will cause the 


?CAN’'T CONTINUE ERROR 


message. 


If CONT is used in a deferred execution statement, the program's execution is halted at that 


statement, but control of the computer is not returned to the user.. The user can regain 
control of the computer by issuing a ctrl C command, but an attempt to CONTinue program 
execution in the next statement merely relinquishes control to the halted program again. 


SCALE imm & def 
SCALE = aexpr 


sets scale size for shape to be drawn by DRAW or XDRAW to factor from 1 (point for point 
reproduction of the shape definition) to 255 (each vector extended 255 times) as specified 
by /aexpr/. NOTE: SCALE = 0 is maximum size and onto a single point. 


SCALE parses as a reserved word only if the next non-space tharacter is the replacement 
sign (=). 


SHLOAD im & def 
SHLOAD 


“\ 
Loads a shpae table from cassette tape. Shape table is loaded just below HIMEM: and 
HIMEM: is set to just below the shape table to protect it. The shape table’s starting address 
is given to BASE’s shape-drawing routines automatically. If a second shape table is loaded, 
replacing the first table, HIMEM: should be reset prior to loading to avoid wasting memory. 
Shape table tapes are prepared using the instructions at the beginning of this chapter. 


set HIMEM:- 16348 befoe SHLOAD and do not use HGR. If you are sure there is enough 
safe memory above. location 24575 to hold your shape table, there is nothing to worry 
about. 


Only reset can interrupt SHLOAD. If the reserved word SHLOAD begins a variable name, 
the reserved-word command may be executed before any?SYNTAX ERROR is given. The 
statement 


SHLOADER = 59 
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hangs the system, while BASE waits indfinitely-for a program from me cassette recorder. 


Use reset ctrl C ta regain control of the computer. 
SCRN imm & def 
SCRN (aexpr7, aexpr2) 


In low-resolution GRaphics mode, the function SCRN returns the color code of the point 
whose x coordinate 1s /aexpr1/ and whose y coordinate is /aexpr2/. 


Althrough low-resolution GRaphics plots points at screen positions (x, y) where x is in the 


range O through 39 and y is in the range 0 through 47, the SCRN function accepts both x . 
and y values in the range O through 47. However, if SCRN is used with an x value (aexpr1/) 


in the range 40 through 47, the number returned gives the color at the point whose x 
coordinate is (/aexpr/ —40) and whose y coordinate is (aexpr2 / +16). If (/aexpr2/ +16) is in 
the range 39 ‘through 47, in nomral mixed GRaphics plus text mode, the number returned 
by SCRN is related to the text character at that position in the text range 48 through 63, 
SCRN returns a number unrelated to anything on the screen. 


In TEXT mode, SCRN returns numbers in the range 0 through 15 whose value is the 


upper four bits, if aexpr2 is odd; or 
lower four bits, if aexpr2 is even .. 


of the character at character position 
(aexpr1 + 1, INP ((aexpr2 + 1) /2)). 


So the expression 


_(CHR$ (SCRN(X-1, 2*(Y-1) + 16*SCRN(X-1, 2*(Y-1) + 1)) 


will return the character at character position (X, Y). 


In High-resolution GRaphics mode, SCRN continues to “look at” the low-resolution 
GRaphics-area, and the numberSCRN returns is not related to the high-resolution display. 


SCRN is parsed as a reserved word only if the next non-space character is a left parenthesis. 


STORE imm & def. 
RECALL imm & def 


STORE avar 
RECALL avar 


These commands store and recall arrays from cassette tape. 


Array names are not stored. with their values, so an’array may be read back using adittorasit 
name tharrused with the STORE command. 


~ The dimensions of the array named by the RECALL statement should be identical to the 


dimensions of the original array as it was STOREd. For example, if an arrary dimensioned 
bySDIM A(5, 5, 5) is STOREd, then one might this will result in scrambled numbers in the 
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RECALLed array, extra zeros in the array, or the 7?0OUT OF MEMORY ERROR. 


In general, you will be given the ?0UT OF MEMORY ERROR message only when the 
total number of elements reserved for the array being RECALLed is insufficient to contain 
all of the elements of the array that was STOREd. 


DIM A(5, 5,5) 
STORE A 


save 6*6*6 elements on the cassette tape. 


DIM B(5, 35) 
RECALL B 


will result in the message 


ERR 


and scrambled numbers in array B, but program execution will continue. 
However 


DIM B(5, 25) 
RECALL B 


will cause the 
?0UT OF MEMORY ERROR 


to be displayed, and program execution will cease. In this case, array B contained 6*26 
elements -- too few elements-to contain all the elements of array A. 


If the array RECALLed has the same number of dimenisions [DIM A(5, 5, 5) specifies an 
array of three dimensions, each of size 6] as the array which was STOREd, any of the 
dimensions of the RECALLed array may be larger than the corresponding dimension of the 
STOREd array. However, scrambled numbers in the RECALLED array will result unless it is 
the last dimension of the RECALLed array which is larger than the last dimension of the 
storEd: array. In every case you will find extra zeros stored in the excess elements of 
RECALLed array, but only in this last case will you find the zeros where you would expect 


them. After storing an array with 


DIM A(5, 5,5) 
STORE A 


you will find-that 


DIM B (10,5, 5) 
RECALL B 


and also 


DIM B (5, 10,5) 
RECALL B 
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both fill array B-withmixed-up numbers from array A; while 


DIM B (5, 5, 10) 
RECALL B 


works fine, with zeros in array’ B’s extra elements. 


We have discussed two “rules’’ for STOREing and RECALLing arrays with equal numbers of 

dimensions: 

1. Only the last dimension of the array RECALLed may be larger than the last dimension 
of the array STOREd. 

2. The total number of elements RECALLed must at least equal the number of elements 
STOREd. 


If rule 2. is followed, and if rule 1. is followed for the dimensions which are common to 
both arrays (these must be the first dimensions), then one may RECALL an array with more 
dimensions than the array that was STOREd. An ERR message is displayed, but program 
~ execution continues . 


DIM B(5,5,5, 5) 
RECALL B 


will work fine in the above example (after the ERR message, and with many extra zeros in 
array B), but 


DIM B(5,5, 3,5): 
RECALL B 


will fill array B with scrambled numbers (after the ERR message), and 


DIM B(5, 5, 1, 1) 
RECALL B 


will cause the 
- ?0UT OF MEMORY ERROR 


because the 6*6*2*2 elements in array B are fewer than the 6*6*6 elements STOREd in 
array A. 


Only real and integer arrays may be stored. String arrays must be converted to an integer 
array using the ASC function order to be stored. 


Although STORE and RECALLrefer to their variables without mention of subscript or 
dimension, only arrays may be STOREd or recalled. The program 


100 A(3) = 45° 
110 A = 27 
120 STORE A 


_ stores on tape the array elements A(O) through A(10) (by default, the array is dimensioned 
to eleven elements), not the variable A (which equals 27 in the program). 
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There is no prompting message or any other signal issued by the STORE instruction: the 
user must have the recorder running in record mode when the instruction is executed. A 
“beep” signals the beginning of the recording, and another “beep” signals the end. 

The program 


300 DIM B(5, 13) 

310 B= 4 

$20 RECALL B 

reads from tape the 84 (6*14) array elements B(O, 0) through B(5, 13). The value of the 
variable B is not changed. Again, there is no prompting message; “beeps” signal the 
beginning and the end of the recordina 


If either STORE or RECALL contains an array name not previously DIMensioned or used 
with a subscript, the message 


?0UT OF DATA ERROR 
is given. In immediate-execution mode, if either STORE or RECALL refers to an array 


name that is defined in a deferred-execution program line, then the deferred-excution 
program line must have been executed prior to the STORE or RECALL. 


STORE and RECALL can be interrupted only by reset. 


If the reserved words STORE or RECALL are used as the first characters of any variable 
name, the commands may be executed before any 


?SYNTAX ERROR 

message is given. The statemént 
STOREHOUSE = 5 | 

will cause the 


20UT OF DATA ERROR 


message, unless and array has been defined whose name begins with:the characters HO. In 
the later case BASE will attempt to STORE the array: first you'll hear one beep, then a~ 
second; finally the message 


?SYNTAX ERROR 


will be printed as BASE tries to parse the rest of the statment, ‘‘=5"’. To cut short the beeps 
and error message you can press the RESET key. 


The statement 
RECALLOUS = 234 
will cause the 


OUT OF DATA ERROR 
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message to be displayed, unless and array has been defined whose name begins with the 
characters OU. In the latter case, BASE will wait indefinitely for an array to arrive from the 
cassette recorder. The only way to regain control of the computer is to press the RESET 
key. , 


4-3-53 SPC imm & def 
SPC (aexpr) 


must be used in a PRINT statement, and aexpr must be enclosed in parentheses. Introduces 
/aexpr/ spaces between the item preivously printed (or, by default, the left margin of the 
text window), and the next item to be printed, if the SPC command.concatenated with the 
items prceeding and following, by juxtagposition or by intervening semi-colons. SPC(O) does- 
_ not introduce any space. 
/aexpr/ must be in the range 0 to 255, inclusive, or the message 
?ILLEGAL QUANTITY ERROR 
appears. However, one SPC(aexpr can be concatenated to another in the form 
PRINT SPC(250) SPC(139) SPC(255) 
and so on, to provide arbitrarily large positive spaces. 
Note that while HTAB moves the cursor to an absolute screen position relative to the left 
margin of the text window, SPC(aexpr) moves the cursor a given number of spaces away 
from the previously printed item. This new position may be anywhere in the text window, 


depending on the location of the previously printed item. © 


Spacing beyond the rightmost limit of the text window causes spacing or printing to resume 
at the left edge of the next lower line in the text window. 


When printing in tab fileds, spacing may be within a tab field or across into another tab 
field,.or it may occupy a tab field of its own. 


lf /aexpr/ is a real, it is converted to an integer. 

SPC is parsed as a reserved word only if the next non-space character is a left parenthesis. 
4—3-—54 STR$ im & def 

STR$ (aexpr) 

This function converts /aexpr/ into a string which represents that value. aexpr is evaluated 

before it is converted to a string. STR$(100 000 000 000) returns 1E+11. 

\f /aexpr/ exceeds the limits for reals, then the message 


?70VERFLOW ERROR 


is displayed. 
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TEXT 


No parameters. Sets the screen to the usual full-screen text mode (40 characters per line, 24 
lines) from low-resolution graphics mode or either of the two high-resolution graphics 
modes. The prompt and cursor are moved to the last line of the screen. If issued in text 
mode, TEXT is equivalent to VTAB 24. 

A statement such as 

175 TEXTILE = 127 

causes execution of the reserved word TEXT before the 

?SYNTAX ERROR 

message appears. 

TAB imm & def 

TAB (aexpr) 


TAB must be used in a PRINT statement, and aexpr must be enclosed in parentheses. TAB 
moves the cursor to the position that is /aexpr/ printing positions from the left margin of 
the text window if /aexpr/ is greater than the value of the current cursor position relative to 
the left margin. If /aexpr/ is less than the value of the current cursor position, then the 
cursor is not moved -- TAB never moves the cursor to the left (use HTAB for this). 


\f TAB moves the cursor beyond the rightmost limit of the text window, the cursor is 
moved to the leftmost limit of the next lower line in the’ text window, and spacing 
dontinues from there. | 

TAB(0) puts the cursor into position 256. 

/aexpr/ must be in the rangé 0 through 255, or the message 

?ILLEGAL QUANTITY ERROR 

is presented. 

TAB is parsed asa reserved word only if the next non-space character is a left parenthesis. 


TRACE imm & def F 
NOTRACE imm & def 


TRACE 
NOTRACE 


TRACE sets a debug mode that displays the line numberof each statement as it is executed. 
When the program also prints on the screen TRACEs may be displayed in an unexpected 
fashion or overwrittin. NOTRACE turns off the TRACE debug mode. 
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Once set, TRACE is not turned off by RUN, CLEAR, NEW,.DEL or reset; reset ctr! B truns 


off TRACE (and eliminates any stored program). 

USR imm & def 

USR (aexpr) 

This function passes /aexpr/ to a machine-language subroutine. 


This argument aexpr is evaluated and put into the floating point accumulator (locations $9D 
through $A3), and a JSR to location $0A is performed. Locations $0A through $0C must 
contain a JMP to the. beginning location of the machine-language subroutine. The return 
value for the function is placed in the floating point accumulator. 


To obtain a 2-byte integer from the value in the floating-point accumulator, your subroutine 
should do a JSR to $E10C. Upon return, ‘the integer value will be in locations $A0 (high- 
order byte) and $A1 (low-order byte). 


To convert an integer result to its floating-point equivalent, so that the function can return 
that value, place the two-type integer in registers A (high-order byte) and Y’ (low-order 
byte). Then do JSR to $E2F2. Upon return, the floating-point value will be in the floating- 
point accumulator. 


To return to BASIC, do an RTS. 


Here is a trivial program using tne USR function,,just to show you. the format: 


] sas 

* OA:4C 00 03 
* 0300:60 

* E003G [RETURN] 

] PRINT USR(8)*3 

24 


At location $QA, we put a JMP (code 4C) to location $300 (low-order byte first, then high- 
order byte). At location $300, we put an RTS (code 60). Back in BASE, when USR(8) was 
ecnountered the argument 8 was placed in the accumulator; the Monitor did a JSR to 
location $0A where it found a JMP to $300. In $300 it found an RTS which sets it back to 
BASIC. The value returned was just the original value 8 in the accumulator, which BASIC 
then multiplied by 3 to get 24. 


-VLIN imm def 
VLIN aexpr1, aexpr2, AT aexpr3 


In low-resolution GRaphics mode, draws a vertical line from (/aexpr1/, /aexpr3/) to 
(aexpr2/, /aexpre/. The color is determined by the most recently executed COLOR 
statement. 


/aexpr2/ and aexpr2/ must be in the range 0 through 47, /aexpr3/ must be in the range O 
through 39, or the message 


?7ILLEGAL QUANTITY ERROR 
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is displayed. /aexpr1/ may be greater than equal to, or less than /arxpr2/. 


If the system is in TEXT mode when VLIN is used, or in mixed GRaphics-plue-text with 
/aexpr2/ in the range 40 through 47, the portion of the line within the text area will appear 
as a line of characters, placed where the graphic dots would have been plotted. 


The command has no visible effect when used in high-resolution graphics mode. 
4—3-—60 VTAB imm & def 


VTAB aexpr 


Moves thé cursor to the line that is /aexpr/ lines down on the screen. The top line is line 1; 
the bottom line is line 24. this statement may involve moving the cursor either up or down, 
but never to the right or left. Arguments outside the range 1 to 24 cause the message 


?7ILLEGAL QUANTITY- ERROR 
to appear. 
VTAB uses absolute moves, relative only to the top and bottom of the screen: it ignores the 
text window. In graphics mode, VTAB will move the cursor into the graphics area of the 
screen. If VTAB moves the cursor to-a line below the text window, all subsequent printing 
takes place on that line. 

4—3—61 VAL imm & def 
VAL (sexpr) 


This function attempts to interpret a string as real or an integer, returning the value of that 
number. 


The first character of the string must be a possible item in a number (leading spaces are 
acceptable), or O is returned. Each character thereafter is likewise examined, until the first 
‘definitely non-numeric character is encountered (interving spaces, decimal points, + and — 
signs, and E are all possible numeric characters in the correct context). The first non- 


numeric character and all subsequent, characters are ignored, and the string to that point is 
evaluated as real or an integer. 


If a string concatenation consisting of more than 255 characters is the argument of VAL, 
the message 


?STRING TOO LONG ERROR 
is given. 


If the absolute value of the number returned is greater than 1E38, or if the number contains 
more than 38 digits (including|trailing zeroes), the message. " 


?70VERFLOW ERROR 


is presented. 
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XDRAW imm & def 
XDRAW aexpr1 [AT aexpr2, aexpr3] 


This command is the same as DRAW, except that the color used to draw the shape is the 
complement of the color are complements: 


Black and White 
Blue and Green 


The purpose of XDRAW is to provide an easy way to erase: if you XDRAW a shape, and 
the XDRAW it again, you'll erase the shape without erasing the background. 


WAIT imm & def. 
WAIT aexpr1, aexpr2, [, aexpr3] 


Allows user to insert a conditional pause into a program. Only reset can interrupt a WAIT. 


./aexpr1/ is the address of a memory location; it must be in the range —65535 through 


65535 to avoid the 
?ILLEGAL QUANTITY ERROR > 


message. In practice, /aexpr1/ is usually limited to the range of addresses corresponding to 
locations at which valid memory devices exist, from O through the maximum value of 
HIMEM: in your computer. See HIMEM: and POKE for more details. Equivalent positive 
and negative addresses may be used. ; . 


/aexpr2/ and /aexpr3/ must be in the range O through 255, decimal. When WAIT is 
executed, these values are converted to binary numbers in the range 0 through 11111111. 


It only aexpr1 and aexpr2 are specified, each of the eight bits in the binary contents of 
location yaexpr1/ is ANDed with the corresponding bit in the binary equivalént of /aexpr2/. 
For each bit, this gives a zero unless both of the corresponding bits are high (1). If the 
results of this process are eight zeros, then the test is repeated. If any result is non-zero 
(which means at least one high (1) bit in /aexpr2/ was matched by a corresponding high (1) 
bit at location /aexpr1/), the WAIT is completed and the BASE program resumes execution 
at the next instruction. , 


WAIT aexpr1, 7 


causes. the program to pause until at least one of the three rightmost bits at location 
/aexpr1/ is high (1). 


WAIT aexpr1, 0 

Causes the program to pause forever. 

lf all three parameters are specified, then WAIT performs as follows: first, each bit in the 
binary contents of location /aexpr1/is XORed with the corresponding bit in the binary 


equivalent of /aexpr3/. A high (1) bit in /aexor3/ aives a result that is the reverse of the 
corresponding bit at location/aexpri/ (a 1 becomes a 0; becomes a 1).'A low (0) bit in 
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/aexpr3/ gives a result that is the same as the corresponding bit at location /aexpr1/. If 
/aexpr3/ is just zero, the XOR portion does nothing. 


Second, each result is ANDed with the corresponding bit in the binary equivalent of 
/aexpr2/. |f the final results are eight zeros, the test is repeated. If any result is non-zero, the 
WAIT is completed and execution of the BASIC program continues at the next instruction. 


Another way to look at WAIT: the object is to test the contents of location /aexpr1/ to see 
when any one of certain bits is high (1, or on) or any one of certain other bits is low (0, or 
off). Each of the eight bits in the binary equivalent of /aexpr1/: 1 means you are interested, 
O means ignore that bit. Each of the eight bits in the binary equivalent of /aexpr3/ indicates 
which state you are WAITing for the corresponding bit in location /aexpr1/ to be.in: 1 
means the bit must be low, zero means the bit must be high. If any of the bits in which you 
have indicated interest (by a 1 in the corresponding bit of /aexpr2/) matches the state you 
specified for that bit (by the corresponding bit of /aexpr3/) the WAIT is over. If aexpr3 is 
omitted, its default value is zero. 


For instance: 

WAIT aexpr1, 255, 0 means pause until at least one of the 8 bits at location /aexpr1/ 
is igh. 

WAIT aexpr1, 255 Identical to the above, in operation. 


WAIT aexpr1, 255, 255 means pause until at least one of the 8 bits at location /aexpr1/ 
is low. 


Wait aexpr1, 1, 1 means pause until the rightmost bit at location /aexpr1/ is low, 
regardless of the states of the other bits. 


WAIT aexpr1, 3, 2 means pause until either the rightmost bit at location /aexpr1/ 
is high, or the next-to-rightmost bit is low, or both Gonditions 
exist. 


4—4 BUILT-IN FUNCTIONS 


All functions may be used wherever an expression of the same type may be used. They may be used in 
either immediate or deferred execution. Here are brief descriptions of some of BASE’s arithmetic 
functions. Other functions are described in sections dealing witn similar instructions. 


SIN (aexpr) 
Returns the sine of /aexpr/ radians. 


COS (aexpr) 
Returns the cosine of /aexpr/ radians. 


TAN (aexpr) 
Returns the tangent of /aexpr/ radians. 


ATN (aexpr) : 
Returns the arctangent, tn radians, of /aexpr/. The angle returned is in the range -pi/2 through +pi/2 


radians. 


INT (aexpr) 
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Returns the largest integer less than or equal to /aexpr/. 


RND (aexpr) 
Returns a random real number greater than or equal to 0 and less than 1. 


lf /aexpr/ is greater than zero, RND (aexpr) generates a new random number each time it is used, 


lf /aexpr/ is less than zero, RND{(aexpr) generates the same random number each time it is used with 
the same /aexpr/, as if from a permanent random number table built into the BASE. If a particular 
negative argument is used to generate a random number, then subsequent radom numbers generatéd 
with positive arguments will follow the same sequence each time. A different random sequence is 
initialized by each different negative argument. The primary reason for using a negative argument for 


RND is to initialize (or “‘seed"’) a repeatable sequence of random numbers. This is particularly helpful 
in debugging programs that use RND. 


If /aexpr/ is zero, RND(aexpr) returns the m 
and NEW do not affect this). Some 
variable in order to save it. 


ost recent previous random number generated (CLEAR 
times this is easier than assigning the last random number to a 


SGN (aexpr) 
Returns -1 if /aexpr/ <0, returns 0 if /aexpr/=0, and returns 1 if /aexpr/>0. 
ABS (aexpr) : 
Returns the absolute value of /aexpr/ ie. /aexpr/ if /aexpr/>=0, and -/aexpr/ if /aexpr/>0. 
SOR (aexpr): 
. Returns the positive Square root. This is a special implementation that executes more quickly than 
EXP (aexpr) 
Raises e (to 6 places, €=2.718289) to the indicated power, /aexpr/. 


me) 


LOG (aexpr) 
Returns the natural logarithm of /aexpr/. 


4—5 DERIVED FUNCTIONS 


The following functions, while not. intrinsic to BASE BASIC, can be 
BASIC functions and can be easily implemented by using the DEF EN fy 


SECANT: 
SEC(X) = 1/COS(X) 


calculated using the existing 
nection. ; ; 


COSECANT: CSC(X) = 1/SIN(X) 


COTANGENT: 
COT(X) = 1/TAN(X) 


INVERSE SINE: ARCSIN(X) = ATN(X/SQR(-X*X+1)) 


INVERSE .COSINE: 
ARCCOS(X) = -ATN (X/SQR (-X*X+1))+1.5708 


INVERSE SECANT: 
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ARXSEC(X) = ATN (SQR(X*X-1))+(SGN(X)-1)*1.5708 


INVERSE COSECANT: 
ARCCSC(X) = ATN (1/SQR(X*X-1))+(SGN(X)-1)*1.5708 


INVERSE COTANGENT: 
ARCCOT(X) = -ATN(X)+1.5708 


HYPERBOLIC SINE: 
SINH = (EXP(X)—EXP(-X))/2 


HYPERBOLIC COSINE: 
COSH(X) = (EXP(X)+EXP(—X))/2 


HYPERBOLIC TANGENT: 
TANH(X) = —EXP(—X)/(EXP(X)+EXP(—X))*2+1 


HYPERBOLIC SECANT: 
SECH(X) = 2/(EXP(X)+EXP(—X)) 


HYPERBOLIC COSECANT: 
CSCH(X) = 2/(EXP(X)—EXP(—X)) 


HYPERBOLIC COTANGENT: 
COTH(X) = EXP(—X)/(EXP(X)—EXP(—X)*2+1 


INVERSE HYPERBOLIC SINE: 
ARGSINH(X) = LOG(X+SQR(X*X+1)) 


INVERSE HYPERBOLIC COSINE: 
ARGCOSH(X) = LOG(X+SQR(X*X-1)) 


INVERSE HYPERBOLIC TANGENT: 
ARGTANH(X) = LOG((1+X)/(1-X))/2 


INVERSE HYPERBOLIC SECANT: 
ARGSECH(X) = LOG((SQR(—X*X+1)/X 


INVERSE HYPERBOLIC COSECANT: : 
ARGCSCH(X) = LOG(SGN(X)*SQR(X*K+1)+1)/X 


INVERSE HYPERBOLIC COTANGENT: 
ARGCOTH(X) = LOG(X+1)/(X—1)/2 


A MOD B 
MOD(A) = INT((A/B—INT(A/B)*B+.05)*SGN(A/B) 


4—6 HOW TO CREATE A SHAPE TABLE 
BASE has five special commands which allow you to manipulate shapes in high-resolution graphics: 


DRAW, XDRAW, ROT, SCALE, and SHLOAD. Before these BASIC commands can be used, a 
shape must be defined by a “shape definition.” This shape definition consists of a sequence of plotting 
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vectors that are stored in a series of bytes in BASE’S memory. One or more such shape definitions, 
with their index, make up a shape table’’ that can be created from the keyboard and saved on disk 
or cassette tape for future use. 


Each byte in a shape definition is divided into three sections, and each section can specify a “plotting 
vector’: whether or not to plot a. point, and also a direction to move (up. down, left, or right). 
DRAW and XDRAW step through each byte in the shape definition section by section, from the 
definition’s first byte through its last byte. When a byte that contains all zeros is reached, the shape 
definition is complete. 


. This is how the three sections A, B and C are arranged within one of the bytes that make up a shape 
definition: 


Section:: Cc B A 


BitNumber: |7 6. 5 4 3 2 1 = Of. 


Specifies: D > -? Dp: +... Posi. DO 


Each bit pair DD specifies a direction to move, and each bit P specifies whether or not to plot a point 
before moving, as follows: 


IfDD = =O00moveup > 
| = 01 move right If P=O don’t plot 
= 10 move down = 1 do plot- 
= 11 move left 


Notice that the last section, C (the two most. significant bits), does not have a P field (by default, ° 


P=0), so section C can only specify a move without plotting. 


Each byte can represent up to three plotting vectors, one in section A, one in section B, and a third 
(a move only) in’section C. 


DRAW and XDRAW process the sections from right to left (least significant bit to most significant 
bit: section A, then B, then C). At any section in the byte, IF ALL THE REMAINING SECTIONS 


OF THE BYTE CONTAIN ONLY ZEROS, THEN THOSE SECTIONS ARE IGNORED. Thus, the. 
byte cannot end with a move in section C of 00 (a move up, without plotting) because that section,- 


containing only zeros, will be ignored. Similarly, if section C is 00 (ignored), then section B cannot 
be a move of 090 as that will also be ignored. And a move of 000 in section A will end your shape 
definition unless there is a 1-bit somewhere in section B or C. 


Suppose you want to draw a shape like this:(Fig. 1) - 


Figure 1 Figure 2 Figure 3 
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First, draw it'on graph paper, one dot per square. Then decide where to start drawing the shape. 
Let’s strart this one at the center. Next, draw a path through each point in the shape, using only 90 
degree angles on the turns: (Fig. 2) 


Next, re-draw the shape as a series of plotting vectors, each one moving one place up, down, right, 
or left, and distinguish the vectors that plot a point before moving (a dot marks vectors that plot 
points). (Fig. 3) 


Now “unwrap” those vectors and write them in a straight line: 


a ee Oe 


Next draw a table like the one in Figure 4, below: 
A ‘ Vector C Code 
000 ; 


Section C B A 
Byte O 


2 2 Tiid 010 or 10 Only 
a\—» t t 011 or 11 
4 e—>| |e> 
5 L | |e 100 
6 1 | 101 Plot 
5 Pl ' 110 & Move 
8 as 11s 
9 000 | —— Denotes End 
of shape 
Definiti 
This Vector Sunn 
Cannot Plot 
or Move Up 


. Figure 4° 


For each vector in the line, determine the bit code.and place it in the next available section in the 
table. If the code will not fit (for example, the vector in section C can’t plot a point), or is a O00 
(or 000) at the end of a byte, then skip that section and go on to\the next. When you have finished 
coding all your vectors, check your work to make sure it is accurate. , 


Now make another table, as shown in Figure 5 below, and re-copy the vector codes from the first 
table. Recode:the véctor information into a series of hexadecimal bytes, using the hexadecimal codes 
from Figure 6. ; 


Bytes Codes 
Section: C B A Recoded 
in Hex Binary . Hex 
Byte 0 00010010 = 12 0000 = QO 
1 0011 TT1 = SF: 0001 ‘= 1 
2 00100000 = 20 0010 = 2 
3 01100100 = 64 0011 = 3 
4 4 00101101 = 2D 0100 = 4 
5 5 00010101 = 15 0101 = 5 
6 6 00TT 0110. = 3°76 0110 .= 6 
i 7 00011110 = 1€E 0111 = 7 
8 8 00000111 = 07 . 1000 = 8 
) 9 00000000- = 00 __ Denotes End 1001 = 9 
of Shape 1010 = A 
Hex: Digit 1 Digit 2 Definition 1011 = B 
1100 = C. - 
(Figure 5) — ; ie ss “ 
(Figure6) 1111 = F 


The series of hexadecimal bytes that you arrived at in Figure 5 is the shape definition. There is still 
a little more information you need to provide before you have a complete shape table. 


For this example, your index is easy: there is only one shape definition. The shape table’s starting 
location, whose address we have called S, must contain the number of shape definitions (between 
O and 255) in hexadecimal. In this case, that number is just one. We will place our shape definition 
immediately below the index, for simplicity. That means, in this case, the shape definition will start 
in byte S+4: the address of shape definition #, relative to S, is 4 (00 04, in hexadecimal). Therefore, 
index byte S+2 must contain the value 04 and index byte S+3 must contain the value OO. 


D2: Index to First Byte of Shape 


7 Definition #2, Relative to S 


Byte S+0 + _ Total Number of 
+1 Shape Definitions 
+2 
43 } D1: Index to First Byte of Shape 
+4 ! Definition #1, Relative to A 


+2n Dn: Index to First Byte of Shape, 
+2n+1 - Definition #n, Relative to S ° 
S+D1 
Shape Definition #1 
S+D2 
Shape Definition #2 
S+Dn 


Shape Definition #n 


Last Byte=00 


Figure 7 
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You are now ready to type the shape table into BASE memory. First, choose a starting address. For. 
this example, we'll use hexadecimal address IDFC. (Note: this address must be less than the highest 
memory address available in your system, and not in an area that will be cleared when you use HGR or 
HGR 2. Location IDFC is just below the high-resolution graphics page 1, used by HGR.) Press the 
RESET key to enter the Monitor program, and type the Starting address for your share table: 


IDFG 


if you press the RETURN key now, BASE will show you the address and the contents of that address. 
That is how you examine an address to see if you have a put the correct number there. If instead you 
type a colon (:) followed by a two-digit hexadecimal number, that number will be stored at the 
specified address when you press the RETURN key. Try this: 


IDFC RETURN 

What does BASE say the contents of location IDFC are? Now try this:. 
IDFC: 01 RETURN 

IDFC— RETURN 

IDFC— 01 


The BASE now says that the value 01 (hexadecimal) is stored in the location whose address is IDFC. 


_To, store more two-digit hexadecimal numbers in> successive bytes in memory, just open the firt 


address: 

IDFC: 

and then type the numbers, separated by ae 

IDFC:01 00 04 00 12 3F 20 64 2D 15 36 1E 07 00 RETURN 


You: have just typed in your first complete shape table....not so bad, was it? To check the information 
in your shape table, you can examine each byte separately or simply press the RETURN key re- 
peatedly until all the bytes of interest (and a few extra, probably) have been displayed: 


IDFC return 

IDFC— 01 

*return 

00 04 00 

*return 

1EO0-— 12 3F 20 64 2D 15 361E 
*return 

1E08— 07 00 DF 1E 23 00 00 FF 


If your shape table looks correct, all that remains is to store the starting address of the shape table 
where BASE can find it (this is done automatically wuen you use SHLOAD to get a table from 
cassette tape). BASE looks for the four hex digits of the table's starting address in hex locations E8 
(lower two digits).and EQ (upper two digits). For our table’s starting address of 1D FC, this would 
do the trick: | 
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E8:FC 1D return 


To protect your shape table from being accidentally erased by your _ BA S| C program, it might 
also be a good: idea to set HIMEM: (in hex locations 73 and 74) to the table’s starting address: 


73:FC 1D 
This too is done automatically when you use SHLOAD to get the table from cassette tape. 
SAVING A SHAPE TABLE 


To save your shape table on tape, you need to know three things: 


1) Starting address of the table (1DFC, in our example) 
2) Last address of the table (1E09, in our example) 
3) Difference between 2) and 1) (OOOD, in our example) 


Item :3, the difference between the last address and the first address of the table, must be stored in 


hex locations 0 (lower two digits) and 1 (upper two digits): 


0:0D 00 return 


Now you can “Write” (store on cassette) first the table length that is stored in locations O to 1, and 


then the shape table itself that is stored in locations Starting Address through Last Address: 


0.1W 1DFC. 1EO9W 


Don't press tne RETURN key until you have put a cassette in your tape recorder, rewound it, and 
started it recording (press PLAY and RECORD simultaneously). Now press the computer’s RETURN 


key. 
To use the tape, rewind it, start it playing (press PLAY), and (in BASIC, now) typé. © 


SHLOAD return 


You should hear one “beep” when the table’s length has been read successfully, and another “beep” 


when the table itself has been read. 


USING A SHAPE TABLE 


You ‘are now ready to writ an BASE program using the shape-table commands DRAW. XDRAW, 


ROT and SCALE 


Here’s a sample BASE program that will print our defined shape, rotate it 16 degrees, and then repeat, 


each repetition larger than the one before. 


10 HGR ; 
20 Hcolor=3 : 
30 FOR R=11T0O50 
40 ROT=R 
50 SCALE=R 
60 DRAW 1 AT 139, 79 
70 NEXT R 
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To see a single ‘‘square”’, add a line 

65 END 

TO pause and then erase-each square after it is drawn add these lines: - 
63 FORI!I=0 TO 1000: NEXT | 

65 XDRAW 1 AT 139, 79, 


PATN 

When you want to creat shape tables let PATN statement helps you! 
]PATN RETURN 

the screen will display 

NEW? Y>ES, N>0O 


lf you want to clear entire buffer press Y key, otherwise press N key the data will remain. 
Afterward the screen will display: 


DRAW: [> UP, J>LEFT, K> RIGHT, M>DOWN 
PASS: Y>UP, G>LEFT, H>RIGHT, B>DOWN, E>END, N>NEXT, *PATTERN NUMBER>O1 
YOUR KEY: YOUR DATA>00 000 000 


On screen it’s the rule of using PATN statement to creat shape tables, when your table is complete, 
press E key, BASE will back. 


* it you have created not only one shape table, pattern number will increment every time. 


Chapter 5 SYSTEM MONITOR 


The BASE System Monitor program begins at location number $FF69 in memory. To enter the Monitor, 
you,or your BASIC program can CALL this location. The Monitor's prompt (an asterisk[*] ) will appear on 
the left edge of the screen, with a flashing cursor to its right. The Monitor accepts standard input lines just 
like any other system or language on BASE it will not take any action until you press RETURN . Your 
input lines to the Monitor may be up to 255 characters in length. When you have finished your stay in the 


Monitor, you can return to the language you were previously using by typing CTRLB RETURN or 
simply press RESET.* 


5--1 THE TINY-ASSEMBLER (BASE 64A only) 


There is a program within the Monitor which allows you to type programs into the BASE in the same 
assembly format which the LIST command displays. This program is called the BASE Tiny-Assembler. 


It is a ‘Tiny’ -assembler because it cannot understand symbolic labels. something that a full-blown 
assembler must do. To run the Tiny Assembler, type: 


*X LRETURN | 


You are now in the Tiny Assembler. The ‘>‘’ is the prompt character. During your stay in the Tiny 
Assembler, you can execute any Monitor command by preceding it with a dollar sign ($). Aside from 
that, the Tiny-Assembler has an instruction set and syntax all its own. 


The Tiny-Assembler remembers one address, that of the Program Counter. Before you start to enter a 
program, you must set the Program Counter to point to the location where you want your program to 
go. Do this by typing the address followed by a colon. Follow this with the: mnemonic for the first 


. instruction in your program, followed by a space. Now type the operand of the instruction. Now ° 


press RETURN. ~ The Tiny-Assembler converts the line you typed into hexadecimal, stores it 
in memory beginning at the location of the Program Counter, and then disassembles it again and 
displays the disassembled line on top of your input line. In then poses another prompt on the next 
line. Now it’s ready to accept the second instruction in your program To tell it that you want the next 
instruction to follow the first, don’t type an address or a colon, but only a space, followed by the next 
instruction’s mnemonic and operand. Press RETURN . It assembles that line and waits for another. 


If the line you type has an error in it, the Tiny-Assembler will beep loudly and disply a circumflex (A) 
under or near the offending character in the input line. Most common errors are the result of 


typographical mistakes: misspelled mnemonics, missing parentheses, etc. The Tiny-Assembler also will - 


reject the input line if you forget the space before or after a mnemonic or include an extraneous 
character in a hexadecimal value or address. If the destination address of a branch instruction is out of 
the range of the branch (more than 127 locations distant from the address of the instruction), Tiny- 
Assembler will also flag this as an error. Following in an example. 


"Xx 


>1000: LDA #$10 


1000- A9 10 LDA  #$10 
> ASPACE STA $2000 

1002. 8D 00:20 STA $2000 
> LDA #$20 


1005- A9 20 

> STA $300 

1007- 8D 00 30 
> TAX 
100A- AA 

> TAY 

100B- A8 

> PHA 
100C— 48 

> PLA 

100D- 68 

> LDX #$FF 

100E- A2 FF 

> LDY $2000 

1010-_ AC 00 20 
> CMP #$10 

1013- C9 10 

» JMP $1000 

1015 4C 00 10 
>$FF69G 


5—2 THE LIST COMMAND 


The LIST command to the Monitor will start at the specified location 
lines) of instructions: . 


*1000L 
1000- A9 10 
1002- 8D 00 20 
1005: A9 20 
1007- 8D 00 30 
100A- AA 

100B- A8 

100C- 48 

100D- 68 

100E- A2 FF 
1010- AC 00 20 
1013- c9 10 
1015- 4C 00 10 
1018- 00 

1019- 00 


LDA 


STA 


TAX 


TAY 


PHA 


PLA 


LDX 


#$20 


~ $3000 


#$FF 


$2000 


#$10 


$1000 


#$10 ~ 


$2000 
#$20 
$3000 


#$FF 
$2000 
#$10° 
$1000 


and display a screenfull (20 


101A- 00 BRK 


101B- 00 BRK 
101C- 00 BRK 
101D- 00 BRK 
101E- 00 BRK 
101F- 00 BRK 


5-3 THE STEP TRACE & BREAK COMMAND (BASE 64<A only) 


The Monitor provides facilities for stepping through programs to find the bug. The Monitor’s STEP 
command decodes, displays, and excutes one intruction at ‘a time, and the TRACE command steps 
quickly through a program, stopping when a BRK instruction is executed. 


*1000S 

1000- A9 10 LDA —«#$210 
A=10 X=10 X=10 P=30 S=BO 

*§ 

1002- 8D 00 20 STA $2000 
A=10 X=10 Y=00 P=30 S=BO | 

*§ 

1005- A9 20 LDA «#20 
A=20 X=10 Y=00 P=30 S=BO 

*S 

1007- 8D 00 30 STA $3000 
A=20 X=10 Y=00 P=30 S=BO 

*SSSS 

100A- AA TAX 
=20 X=20 Y=00 P=3- S=BO 

100B A8 TAY 
=20 X=20 Y=20 P=30 S=BO 

100C- 48 PHA 

A=20 X=20 Y=20 P=30 S= 

100D- 68 PLA 

A=20 X=20 Y=20 P=30 S=BO 

*1000T 

100- AY 10 LDA ~——« #$:10 
A=10 X=FF Y=10 P=30 S=93 

1002- 8D 00 20 STA $2000 
A=10 X=FF Y=10 P=30 S=93 

1005- A9 20 LDA ~——«#$20 
A=20 X=FF Y=10 P=30 S=93 

1007- 8D 00 30 STA $3000 
A=20 X=FF Y=10 P=30 S=93 

100A- AA TAX 


A=20 X=20 Y=10 P=30 S=93 
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100B- 
A=20 
100C- 
A=20 
100D- 
A=20 
100E- 
A=20 
1010- 
A=20 
1013. 
A=20 
1015- 
A=20 
1000- 


A8 
X=20 
48 


X=FF 
A9 


Y=20 P=30 
Y=20 P=30 
Y=20 P=30 


Y=20 P=30 
00 20 


The following example will show you how to set breakpoint! 


*1000L 


1000- 
1002- 
1005- 
1007- 
100A- 
100B- 
100C- 
100D- 
100E- 
1010- 
1013- 
1015- 
1018- 
1019- 
101A 
101B- 
101C- 
101D- 
101E- 
101F- 


*1015K 


*1000G 
1017- 


*1000L 


1000- 
1002- 


; Listing your program. 
AY 10 LDA 
8D 00 20 STA 
AY 20 LDA 
8D 00 30 STA 
AA TAX 
A8 TAY 
48 PHA 
68 PLA 
A2 FF LDX 
AC 00 20 LDY 
C9 10 CMP 
$C 00 10 JMP 
00 BRK 
00 BRK 
00 BRK 
00 BRK 
00 BRK 
00 BRK 
00 BRK 
00 - BRK 


; Choose your breakpuint at $1015. 


; Let program runs 


A=20 X=Ff Y=10 P31. S=74; Program break. 


; Listing program again! 
we think everybody knows 
how the breakpoint setting (K) works! 


AY 10 
8D 00 20 
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LDA 
STA 


#$10 
$2000 


1005- A9 20 LDA #$20 


1007- 8D 00 30 STA $3000 — 
100A- AA TAX 

100B- A8 TAY 

100C- 48 PHA 

100D- 68 PLA 

100E- A2 FF LDX #$FF 
1010- AC 00 20 LDY $2000 
1013- co 10 CMP #$10 
1015- 4C 00 10 JMP $1000 
1018- 00. BRK 

1019- 00 BRK 

101A- 00 BRK 

101B- 00 BRK 

101C- 00 BRK 

101D- 00 BRK 

101E- 00 BRK 

101F- 00 BRK 


5—4 THE WRITE COMMOND (only BASE 644A has verify function) 


To save a range of memory to tape, give the Monitor the staring and ending addresses of the range, 
followed by the letter W (for WRITE): 


*[start address] . [end address] W (write only). 
*[start address] . [end address] Y (write and verify) 


To get an accurate recording, you should put the tape recorder in record mode before you press 
RETURN. on the input. line. Let the tape run a few seconds, then press RETURN _ The Monitor 
will write a ten-second ‘‘leader’’ tone onto the tape, followed by the data. When the Monitor is 
finished, it will ask you whether you want to verify or not, if you use Y command. 


VERIFY? Y/N . 
If you type ‘’Yes” then it will keep going otherwise it will back to monitor. 


TAPE READY? 
At the meantime you should rewind the tape and let tape recorder in the play mode™, and type any 
key, then verify is go! 


TAPE READY? GO! 

vynen your data on the tape is just the same as you want to save, the monitor will give you a sign of 
“ok!” then sound a “Beep”’ otherwise it will give you another sign of “ERR” then sound a “‘beep”’! 

*If your recoder has only one cable you should remove the cable to the poisition of ‘‘ear’’ and ‘‘tape 


a” 


in’. 
5—5 THE READ COMMAND 


Once you've saved a memory range onto tape with the Monitor’s WRITE command, you can read 
that memory range back by using the Monitor's READ command. The data values which you've stored 
on the tape need not be read back into the same memory range from whence they came; you can tell 
the Monitor to put those values into any simplarly sized memory range in the memory. 


The format of the READ command is the same as that ot the WRITE command, except that the 
command letter is R, not W: 


a a rr i 


— lL 


« [start] . [end] R 


Once again, after typing the command, don’t press RETURN . Instead, start the tape recorder in 
PLAY mode and wait for the tape’s nonmagnetic leader to pass by. Although the WRITE command 
puts a ten-second leader tone on the beginning of the tape, the READ command needs only three 
seconds of this. leader in order to lock on, the the frequency. So you should let a few seconds of tape 
go by before you press RETUREN , to allow the tape recorder’s output to settle down to a steady 
tone. 


5—6 THE MOVE COMMAND 


Your can treat a range of memory (specified by two addresses separated by a period) as an entity 
onto itself and move it from one place to another in memory be using the Monitor’s MOVE 
command. In order to move a range of memory from one place to another, the Monitor must be 
told both where. the range is situated in memory and where it is to be moved. You give this 
information to the Monitor in three parts: the address of the destination of the range, the address 
of the first location in the range proper, and the address of the last location in the range. You 
specify the starting and ending addresses of the range in the normal fashion, by separating them 
with a period. You indicate that this range is to be placed somewhere else by separating the range 
and the destination address with a left caret (<). Finally, you tell the Monitor that you want to move 
the range to the desination by typing the letter M, for ‘‘MOVE”’. The final command looks like this: 


[destination] < [start] . [end] M 


‘When you type this line to the Monitor, of course, the words in curly brackets should be replaced 
by hexadecimal addresses and the spaces should be omitted. Here are some real examples of memory 


moves: 


* 3000 < 1000, 2000M 


5—7 THE VERIFY COMMAND | 


You can use the Monitor to compare two ranges of memory using much the same format as you 
use to move a range of memory from one place to another. In fact, the VERIFY command can 
be used immediately after a MOVE to make sure that the move was successful. 


The VERIFY command, like the MOVE command, needs a range and a destination. In shorthand: 


[destination]:< [start] . [end] V 


The Monitor compares the range specified with the range beginning at the destination address. If 
there is any discrepancy, the Monitor displays the address at which the difference was found and the 


two offending values. 


Notice that the VERIFY command, if it finds a discrepancy, displays the address of the location 
in the original range whose value differs from its counterpart in the destination range. If there is 
no discrepancy, VERIFY displays nothing. It leaves both ranges unchanged. The last opened and 
next changeable locations are set just as in the MOVE command. AS. before, if the ending address 
of the range is less than the starting a dress, the values of only the first locations in the ranges will . 


be compared. 


5—8 HOW TO MANAGE YOUR MEMORY 


5-8-1 CHECK THE CONTENTS OF MEMORY 


When you type the address of a location in memory alone on an input line to the Monitor, it 
will reply with the address you typed, a dash, a space, and the value contined in that 


location, thus: 


*E000 
E000 — 20 
*300 

0300 — 99 


Each time the Monitor displays the value contained in a location, it remembers that location 
as the last opened location. For technical reasons, it also considers that location as the next 


changeable location. 


5-8-2 CHECK SOME MORE MEMORY 


If you type a (.) on an input line to the Monitor, followed by an address, the Monitor will 
display a memory dump. the values contained. in all locations from the last opened location 
to the location whose address you typed following the period. The Monitor then considers 
the last location displayed to be both the last opened location and the next changeable 


location. 
*20 


0020 — 00 
* 2B 


0021 — 28 00 18 OF OC 00000 


0028 — A8 06 DO 07 
*300 


*300 — 99 
#216 


0301 — B9 00 08 OA OA 0A 99 
0308 — 00 08 C8 DO F4 A6 2B AQ 
0310 —09 85 27 AD CC 03 


* 32A 


0316 — 85 41 


0318 — 84 403A 4A. 4A 4A 4A 09 
0320 —CO 85 3F AQ 5D 85 3E 20 


0328 — 43 03 20 


* 


You should notice several things about the format of a memory dump. First, the first line in 
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the dump begins with the address of the location following the last opened location; second, 
all other lines begin with addresses which end alternately in zeroes and eights; and third, there 
are never more than eight values displayed on a single line in a memory dump. When the 
Monitor does a memory dump, it starts by displaying the address and value of the location 
following the last opened location. It then proceeds to the next successive location in 
memory. If the address of that location ends in an 8 or @, the Monitor will “cut” to a new 
line and display the address of that location and continue displaying valués. After it has 
displayed the value of the location whose address you specified, it stops the memory dump 
and sets the address of both the last opened and the next changeable location to be the 
address of the last location in the dump. If the address specified on the input line is less than 
the address of the last opened location, the Monitor will display the address and value of only 
the location following the last opened location. 


You can combine the two commands (opening and dumping) into one operation by con- 
catenating the second to the first; that is, type the first address, followed by a period and the 
second address. This two-addresses-separated-by-a-period form is called a memory range. 


* 300.32F 


0300-99 BO OO 68 GA BA GA 99 
0368-00 08 C8 D@ F4 A6 2B AQ 
0316-—@9 85 27 AD CC @3 85 41 
0318-84 40 40 8A 4A 4A 4A 69 
0326—CO 85 3F AQ 5D 85 3E 26 
0328-43 63 260 46 63 A5 3D 4D 
*30.4@ 


0630—AA 00 FF AA 65 C2 G5 C2 
00306—1B FD DO 63 3C G6 46 OO 
0046-30 

*E015 E025 


E@15—4C ED FD 
E@18—A9 26 C5 24 BO OC AY 8D 
E@20—A@ 07 26 ED FD.AQ 


5—8—3 CHANGING THE CONTENTS OF A LOCATIGw 


You've heard all about the ‘‘next changeable location’, now you're going to use it. Type a 
colon followed by a value. 


*@O 


G000-—G0 
mn: BF 


Presto! The contents of the next changeable location have just been changed to the value you 
typed. Check this by examining that location agina: 


*0 
0000-—5F 


5-8-4 


You can also combine opening and changing into one operation: 


*302:42 
* 302 
0302-42 


When you change the contents of a location, the old value which was contained in that 
location disappears, never to be seen again. The new value will stick around until it is replaced 
by another hexadecimal value. 


CHANGING THE CONTENTS OF CONSECUTIVE LOCATIONS 


You don’t have to type an address, a colon, a value, and press RETURN for each and every 
location you wish to change. The monitor will alow you to change the values of up to eighty- 
five locations at a time by typing only the initial address and colon, and then all the values 
separated by spaces. The Monitor will duly file the consecutive values in consecutive 
Ications, starting at the next changeable location. After it has processed the string of values, it 
will assume that the location following the last changed location is the next changeable 
location. Thus, you can continue changing. consecutive locations without breaking sttide on 
the next input line by typing another colon and more values. . 


*300 : 69 01 20 ED FD 4C 0 3 
*300_ 
0300 — 69 
* RETURN 
01 20 ED FD 4C 00 03 
10:0 12-3 
“sa 6-6 7 
*10117 


0010 —00 01 02 03 04 05 06 07 


5—9 SUMMARY OF MONITOR COMMANDS 


Summary of Monitor Commands. 


Check Memory. 


[adrs] Examines.the value contained in one location. 

fadrs1] . [adrs2] Displays the values contained in all locations between 
[adrs1] and [adrs2] . 

RETUREN Displays the values in up to eight locations following 


the last opened location. 
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Changing the Contents of Memory. 


[adrs] ! [val] [avi] ... 
:[val] val] ... 


Moving and comparing. 


[dest] > [start] . [end] M 
[dest] % [start] . [end] V 


Saving and Loading via Tape. 


[start] . [end] W 

[start] . [end] R 

Running and Listing Programs. 
[adrs] G 

[adrs] L 


Xx 


[adrs] S 


lade T 


[val] + [val] 


[val] — [val] 


CTRL B 


Stores the values in consecutive memory locations 
starting at [adrs] . 


Stores values in memory starting at the next 
changeable location. 


Copies the values in the range [start] . [end] into the 
range beginning at [dest] . 


Compares the values in the range [start] . [end] to 
those in the range beginning at [dest] . 


Writes the values in the memory range [start] . [end] 
onto tape, preceded by a tensecond leader. 


Reads values from tape, storing them in memory 
beginning at [start] and stopping at [end]. Prints 
“ERR” if an error occurs. 


Transfers control to the machine language program 
beginning at [adrs] . 


Disassembles and displays 20 instructions, starting 
at [adrs]. Subsequent L's will display 20 more 
instructions each. 


Exnter Tiny-assembler mode. 


Disassemble, and execute the instruction at [adrs], 
and display the contenst of the 6502's internal 
registers. Subsequent S's will ‘display and execute 
successive instructions. ** 


Step infinitely. The TRACE command stops only 
when it executes a BRK instruction or when you 
press RESET ** 


Add the two values and print the result. 


Subtract the second value from the first and print 
the result. 


Enter the language currently installed in the BASE’S 
ROM. 


Chapter 6 SYSTEM HARDWARE 


6—1 THE MICROPROCESSORS 
6—1—1 INTRODUCTION 
The BASE system is based on 6502 microprocessor. A block diagram of 6502 architecture is 
shown in Figure 6—1. This section begins with an analysis of this block diagram, discussing 


the function of the various registers, data paths, etc. A detailed discussion of the operation of 
the various pins on the chip follows. : 
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¢#—— REGISTER SECTION 


ABL 


LEGEND: 


fi =8BIT LINE 


| = 1 BITLINE 


NOTE: 


INDEX 
nee 


STACK 
POINT 
K+ REGISTER 
(S) 


INDEX 
REGISTER KY 
x 
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RES IRQ NMI 


ae: 


INTERRUPT 
LOGIC 


INSTRUCTION 
DECODE 


* CONTROL SECTION ——»> 


¢———— RDY 


TIMING 
CONTROL 


CLOCK 
CLOCK 00(IN) 
INPUT 


RW 
DBE 


DATA 
BUS 


1. CLOCK GENERATOR IS NOT INCLUDED ON MCS6501. 
6502 Internal Architecture 
FIGURE 6-1 
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VSS 2 02 (OUT) [ 
RDY 3 S.0. 
01 (OUT) 4 02 (IN) [ 
N.C. 5 N.C. 
NMI 6 N.C. [ 
SYNC 7 R/W 
VCC 8 DBO [ 
ABO 4g DBI [ 
ABI 10 DB2 
AB2 1 DB3 [ 
AB3 DB4 
AB4 DB5 [ 
AB5 DB6 
pe DB7 | 
AB? AB15 
nee AB14 [ 
mes AB13 
ae AB12 
AB11 VSS 


N.C. =NO CONNECTION | 


6502 Pinout Designation f 


START-UP SEQUENCE NORMAL ACTIVITY 


GS 
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The internal organization of the processor can be split into two sections. In general, the 
instructions obtained from program memory are executed by implementing a series of data 
transfers in one section of the chip (register section). The control lines which actually cause 
the data transfers to take place are generated in the other section (control section). 
Instructions enter the processor on the data bus, are latched into the instruction register, and 
are then decoded along with timing signals to generate the register control signals. 


The timing control unit keeps track of the specific cycle being executed. This unit is set to 
"TQ" for each instruction fetch cycle and is advanced at the beginning of each Phase One 
clock pulse. Each instruction starts in TO and goes to T1, T2, T3, etc. for as many cycles as 
are required to complete execution of the instruction. Each data transfer, etc., which takes 
place in the register section is caused by decoding the contents of both the instruction 
register and the timing counter. 


Additional control lines which affect the execution of the instructions are derived from the 
Interrupt logic and from the Processor Status register. The Interrupt logic controls the 
processor interface to the interrupt inputs to assure proper timing, enabling, sequencing, etc. 
which the processor recognizes and services. 


The Processor Status register contains a set of latches which serve to control certain aspects 
of the processor operation, to indicate the results of processor arithmetic and logic 
operations, and to indicate the status of data either generated by the processor or transferred 
into the processor from outside. 


Since the real work of the processor is carried on in the register section of the chip, a detailed 
study will be made of this section. The components are: 


*Data Bus Buffers: 

*Input Data Latch (DL) 

*Program Counter (PCL, PCH) 

* Accumulator (A) 

* Arithmetic Logic Unit (ALU) 
*Stack Pointer (S) 

* Index Registers (X, Y) 

* Address Bus Latches (ABL, ABH) 
*Processor Status Register (P) 


At 1 MHz, the data which comes into the processor from the program memory, the data 
memory, or from peripheral devices, appears on the data bus during the last 100 nanoseconds 
of Phase Two. No attempt is made to actually operate on the last 100 nanoseconds of Phase 
‘Two. No attempt is made to acutally opeate on the data during this short period. Instead, it is 
simply transferred into the input data latch for use during the next cycle. The data latch 
serves to trap the data on the data bus during each Phase Two pulse. It can then be 
transferred onto one of the internal busses and from there into one of the internal registers. 
For example, data being transferred from memory into the accumulator (A) will be placed on 
the: internal data bus and will then be transferred from the interanl data bus into the 
accumulator. If an arithmetic or logic operation is to be performed using the data from 
memory and the contents of the accumulator, data in the input data latch will be transferred 
onto the interanl data bus as before. From there it will be transferred onto the internal data 
bus as before. From there it will be tansferred into the ALU. At the same time the contents 
of the accumulator will be transferred onto a bus in the register section and from there into 
the second input-to the ALU. The results of the arithmetic or logic operation will be 
transferred back to the accumulator on the next cycle by transferring first onto the bus and 
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then into the accumulator. All of these data transfers take place during the Phase One clock 
‘pulse. 


The program counter (PCL, PCH) provides the addresses which step the processor through 
sequential instructions in the program. Each time the processor fetches an instruction from 
program memory, the contents of PCL is placed on the low order eight bits of the address bus 
and the contents of PCH is placed on the high order eight bits. This counter is incremented 
each time an instruction or data is fetched from program memory. 


The accumulator is a general purpose 8-bit register which stores the results of most arithmetic 
and logic operations. In additon, the accumulator usually contains one of the two data words 
used in these operations. 


All logic and arithmetic operations take place in‘the ALU. This includes incrementing and 
decrementing of internal registers (except PCL and PCH). However, the ALU cannot store 
data for more than one cycle. 

If data is placed on the inputs to the ALU at the beginning of one cycle, the result is always 
gated into one of the storage registers or to exteranl| memory during the next cycle. Each bit 
of the ALU has two inputs. These inputs can.be tied to various internal busses or to a logic 


_ zero; the ALU then generates the SUM, NAD, OR, etc. function using the data on the two 
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inputs. 


The stack pointer (S) and the two index registers (X and Y) each consist of-8 simple latches. 
These registers store data which is to be used in calculating addresses in data memory. 


The address bus buffers (ABL, ABH) consist of a set of latches and TTL compatible drivers. 
These latches store the addresses which are used in accessing the peripheral devices (ROM, 
RAM, and I/O). 


THE 6502 Pinouts 


Figure 7.1 shows a diagram of the 6502 microprocessor with the various pins designated. 
These pins and their use in microcomputer systems are discussed separately below. 


Vec, Vss--SUPPLY LINES 


The Vcc and Vss pins are the only power supply connections to the chip. The supply voltage 
on pin 8 is +5.0 V DC + 5%. The absolute limit on the Vcc input is +7.0 V DC. 


ABOO-AB15 -- Address Bus ~ 


The address bus buffers on the 6502 is push/pull type drivers capable of driving at least’ 130 
pf and 1 standard TTL load. 


The addressing technique involves putting an address on the address bus which is known to be 
either in program sequence, on the same page in program memory or at a Known point in 
RAM. . 


The specific timing of the address bus is exactly the same for all the processors. The address is 
valid 300 ns (at 1 MHz clock rate) into the 01 clock pulse and stays stable until the next 01 
pulse. This specification will only change for processors which are specified to operate at a 
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higher clock rate. Figure 6—3 details the relation of address bus to other critical signals. 
DBO-DB7-DATA BUS 


The processor data bus is exactly the same for the processors currently available and for the 
software-compatible processors which will be introduced in the near future. All instructions 
and data transfers between the processor and memory take place on these lines. The buffers 
driving the data bus lines have full ‘‘three-state’’ capability. This is necessitated by the fact 
that.the lines are bi-directional. 


Each data bus pin is connected to an input and an output buffer, with the output buffer 
remaining in the ‘‘floating’’ condition except when the processor is transferring data into or 
out of one of the support chips. All inter-chip data transfers take place during the Phase Two 
clock pulse. During Phase One the entire data bus is ‘’floating.”’ 


‘The data bus buffer is a puch/pull driver capable of driving 130 pf and 1 standard TTL load 


at the rated speed. At a 1 MHz clock rate, the data on the data bus must be stable 100 ns 
before the end of Phase Two. This is true for transfers in either direction. 


* R/W-Read/Write 


The Read/Write line allows the processor to control the direction of data-transfers between 
the processor and the support chips. This line is high except when the processor, is writing to 
memory or to a peripheral interface device. 


All transitions on this line occur during the Phase One clock Pulse (Concurrent with the 
address lines). This allows complete control of the data transition which takes place during 
the buffers. They are 


The R/W buffer is similar to the address buffers. They are capable of driving 130 pf and one 
standard TTL load at the rated speed. Again, Figure 1.13 details the relative timing of the 
R/W line. : 


SYNC Signal 


In the MCS6502, a SYNC signal is provided to identify those cycles in which the processor is 
doing an OP CODE fetch. The SYNC line goes high during phase one of an OP CODE fetch 
and stays high for the remainder of that cycle. If the DRY line is pulled low during the phase 
one clock pulse in which the SYNC line went high, the processor will stop in its current state. 
It remains in that state until the RDY line goes high. In this manner, the SYNC signal can be 
used to control RDY to cause single-instruction execution. Figure 6—3 contains a timing 
diagram for this signal. . 


S. O. -- Set Overflow 
This pin sets the overflow flag on a negative transition from TTL one to TTL zero. This is 


designed to work with a future |/0 part and should not be used in normal applications unless 
the user has programmed for the fact the arithmetic also affect the overflow flag. 
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1. During a microprocessor write cycle, R/W signal low, the SYNC pulse does not occur..: 

2. The R/W signal goes high to signal the beginning of a microprocessor read cycle. 

At the beginning of the read cycle a SYNC pulse will be generated. This pulse will last for 

one cycle time. The SYNC pulse indicates that the microprocessor is reading an OP CODE 

from the memory field. In this case the SYNC pulse is high for one cycle as the processor 
reads the OP CODE. 

4. The processor outputs another SYNC pulse indicating it has completed the previous 
instruction and is fetching another OP CODE. In this case three more cycles are needed to 
complete this instruction before the next SYNC pulse is generated. The SYNC pulse is 
aperiodic in that its generation is a function of the program and the resultant lengths of 


the instructions and addressing modes. 


RDY — Ready 


‘The RDY input delays execution of any cycle during which the RDY line is pulled low. This 

line should change during the Phase Once clock pulse. This change is then recognized during 
the next Phase Two pulse to enable or disabl the execution of the current internal machine 
cycle. This execution normally occurs during the next Phase One clock; 


The primary purpose of the RDY line is to delay execution of a program tetch cycle until 
data is available from memory. This has direct application in prototype systems employing 
light-erasable PROMs or EPROMs. Both of these devices have relatively slow-.access times and 
require implementation of the DRY function if the processor is to operate at full speed. 
Without the RDY function a reduction in the frequency of the system clock would be 


necessary. 


The RDY function will not stop the processor in a cycle in which a WRITE operation is being 
performed. If the RDY line goes from high to low during a WRITE cycle the processor will 
execute that cycle and will then stop in the next READ cycle (R/W = 1). | 


6—1—10 NMI — Non-Maskable Interrupt — 


The NMI input, when in the interrupted state, always interrupts the processor after it 
completes the instruction currently being executed. This interrupt is not ‘“‘maskable,” i.e., 
there is no way for the processor to prevent recognition of the interrupt. 
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The NMI input responds to a negative transition. To interrupt the processor, the NMI input 
must go from high (> +2.4V) to low (< +0.4V). It can then stay low for an indefinite period 
without affecting the processor operation and without another interrupt. The processor will 
not detect another interrup until this line goes high and then back to low. The NMI signal 
must be low for at least two clock cycles for the interrupt to be recognized, whereupon new 
program count vectors ($F FFA . $F FFB) are fetched. 


6—1—11 |RO——Interrupt Request 


The interrupt request (IRQ) responds in much the same manner as NMI. However, this 
function can be enabled or disabled by the interrupt inhibit bit in the processor status 
register. As long as thé | flag (interrupt inhibit flag) is a logic 1, the signal onthe | ROpin will 
not affect the processor. . 


The IRQ pin is not edge-sensitive. Instead, the processor will be interrupted as long as the | 
flag is a-logic ‘‘0’’ and the signal on the |RQ input is at GND.'Because of this, the |RQ signal 
must be held low until it is recognized, i.e., until the processor completes the instruction 
currently being executed. If | is set when IRQ goes low, the interrupt will not be recognized 
until | is cleared through software control. To assure that the processor will not recognize 
interrupt more than once, the | flag is set automatically during the last cycle before the 
processor begins executing the interrupt software, beginning with the fetch of program count. a! 


‘ The final requirement is that the interrupt input must be cleared before the | flag is reset. If 
there is more than one active interrupt driving these two lines (OR’ed together), the 
recommended procedure is to service and clear both ‘interrupts before clearing the | flag. 
However, if the interrupts are cleared one at a time and the | flag is reset after each, the 
processor will simply recognize-any interrupts still active and will process them properly but 
more slowly because of the time required to return from one interrupt before recognizing the 
next. If the procedure recommended above is followed, each interrupt will be recognized and 
processed only once. Figure 6—5 provides several examples of interrupts, microprocessor 
recognition of each interrupt (IRQ and NMI), and processor selection of interrupts during 
overlapped requests. 


TUL 


_ Examples of Interrupt Recognition by 6502 — | 

FIGURE 6-5 ~ . ij 

Each major event affecting the microprocessor is numbered in the figure with the correspond- | 
ina explanations below. Ik 
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System Activeity 


Processor is executing from main program and IRQ goes to low state. 
Upon completion of current instruction, the processor recognizes the interrupt, 
stores the contents of PC and P onto the stack and then sets | during the fetch of the 
interrupt vector. 

After servicing the interrupt, |RQ should be reset before resetting the interrupt mask 
bit to avoid double interrupting. 

Before the processor resumes normal main program execution the interrupt mask bit 
will be reset low. 

NMI now goes low, signalling a non-maskable interrupt request. 

The NMI interrupt‘is recognized and serviced in the same manner as | RQ. 

The processor has resumed normal operation when NMI again goes low requesting an 
interrupt. 

The interrupt mask bit is set high in response to the NMI request. 

Here 1RQ has gone low to signal an interrupt request. This request is ignored since 
the NMI interrupt is being serviced and the interrupt mask is set. 

The interrupt mask bit is reset after servicing the NMI ‘interrupt. 

The processor is now able to recognize the IRQ signal, which is still low, and does so - 
DY Setting the infermipt mask DUE. o%..06.6 cas sein bs we REG aa Ses Baas ea 
During the sevicing of |RQ, NMI goes from high to low. The processor then ° 
completes the current instruction and abandons the IRQ interrupt to service NMI. 
NMI is serviced regardless of the state of the interrupt mask bit. 

After completing the NMI interrupt routine, the processor will resume execution of 


- the IRQ routine, even through IRQ has subsequently gone high. 


6—1—12 RES -Reset 


The RES line is used to initialize the microprocessor from a power-down condition. During 
the power-up time this line is held Jow, and writing from the microprocessor is inhibited. 
When the line goes high the microprocessor will delay 6 cycles and then fetch the new 
program count vectors from specific locations in memory (PCL from location. FFFC and 
PCH from location FFFD). This is the start of the user’s code. It should be assumed that 
any time the reset line has been pulled low and then high, the internal states of the machine 
are unknown and all registers must be re-initialized during the restart sequence. 


6—2 THE SYSTEM MEMORY ORGANIZATION 


6—2-1 


THE MAP MEMORY 


The BASE’s 256 page of memory fall into three catgories: RAM (ramdom access memory), 
ROM (Read only memory), and 1/0 locations (Input/output locations) the memory map is 
looks like below: 


System Memory Map 


Page Number: 
Decimal Hex 
- RAM (48K) 
1/0 (2K) 


1/0 ROM (2K) 


$C080"— $C083 $C088 — $08B 


RAM (4K) 
Extra 


RAM (4K) $D000 
Extra $DFFF | 


ROM (12K) | ROM (12K)| RAM (8K) 
$C058 $CO059 Extra 

Link J bank A, Ron 2 2K 

baw) 2\ band 

ee ie 
x 

f cf s System Memory Map fep Jogss 

RAM MEMORY f cf 58 


The BASE uses 4164 (64K) dynamic RAMs for its main RAM STORAGE’ This RAM 
memory is used by both the microprocessor and the video display circuitry. The micro- 
processor and the video display interleave their use of RAM: the microprocessor reads from 
or writes to RAM only during ®0 and the video display refreshes its screen from RAM 
memory during #1. 


The dynamic RAMs are refreshed automatically during 1 by the video generator circuitry. 
Since the video screen is always displaying at least a 1K range of memory, it needs to cycle 


through every location in that 1K range sixty times a second. It so happens that this action - 


automatically refreshes every bit in all 48K bytes of RAM? This, in conjunction with the 


al 
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interlace of the video and microprocessor access cycles, lets the video display, the 
microprocessor, and the RAM refresh run at full speed, without interfering with each other. 


ROM MEMORY 


The BASE can support up to six 8K by 8 mask programmed Read-only Memory 1Cs. One of 
these six ROMs is enabled by a 74LS138 at location F12 on the BASE’s board whenever the 
microprocessor’s address bus holds an address between $D000 and $FFFF The eight Data 
outputs of all ROMs are connected to the microprocessor’s data line buffers, and the ROM's 
address lines are connected to the buffers driving the microprocessor’s address lines AO 


through A10. — L 4 banks , A 44 ac tad 


The ROMs are similar to type 2732 and 2764 programmable ROMs. A m4 yt 
6—2—2 HOW TO USE EXTRA RAM (BASE 64 and BASE 64A only) 
The EXTRA RAM has four states, before you use it you should know them: 


Write only: you can write data in EXTRA RAM ($D 000 — $FFF) 

Read only: you can read dato out only. 

Enable: you can read out and write in the EXTRA RAM. 

Disable: you can’t read out and write in the EXTRA RAM The softswitch $CO80—C083 
can control the state of EXTRA RAM their relationship is shown as following Figure. 
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The softswitch $CO088 — $CO8B can control the state of EXTRA RAM is almost the same as 
$C080 — $C083, the only difference is $D000 — $DFFF RAM are not at the same place. 


6-2-3 AN EXAMPLE OF HOW TO USE THE EXTRA RAM 


Before you turn on the power, turn the RAM switch (a jumper At board location E1) on 
then on the power of BASE and now your EXTRA RAM is in the write only mode. 
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JCALL-151 | 

*F800 < F800. FFFFM ; Write only state. 
*FD11:29 3F 09 40. 

*FD21: 2C 00:CO .10 F5. 

*D530: 20 6A FD. 


*C083 - Now your EXTRA RAM at the enable mode. 
*C082 - EXTRA RAM is in the Disable mode. 

*C080 ; : Read only mode. 

*C083 C083 ; Enable mode. 

*D000:EA 

*D001 < DOOO . DFFFM 

*D000 . DOOF 


DOOO —EA EA EA EA EA EA EA EA 

D008 — EA EA EA EA EA EA EA EA 
*08B C08B The other side of $DO00 — $DFFF. 
*D000. DOOF 

DOOO — FF FF FF .FF FF FF FF FF 

D008 — FF FF FF FF FF FF FF FF 


When you want to use the EXTRA RAM you should move system monitor program into 
EXTRA RAM first, otherwise the BASE will lost it’s control of system like following: 


JCALL-151 
*C083 
C083 — 


There is no response of any: key include reset key. The only way to save your BASE is off 
the power and on it again. You can use EXTRA RAM to develop your own system monitor 
program, or BASIC Interpreter. 


]CALL-151 

*D000 < D000. FFFFM 
*FD11: 29 3F 09 40 
*FD21:2C 00 CO 10 F5 
*D530: 20 6A FD. 
*C083 


* 


*FF6A: AB 
+ — Cursor the cursor won't flashing. 


Now you see what we mean! 


6—2—4 RAM ORGANIZATION AND USAGE 


Sein hs 


Text and Low Resolution 
Primary Page Storage 


"FREE 


Text and Low Resolution 
Secondary Page Storage 


RAM 
High Resolution 
Primary Page 
Storage 


through 
63 


High Resolution 
Sceondary Page 
Storage 


64 
through 
95 © 


96 
through 
191 


EXTRA RAM 


(4k) 
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6—2—5 ZERO PAGE MEMORY MAPS 


Decimal 


Decimal 


Monitor Zero Page usage 
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10 11 12 13 14 14 15 
$6 $7 $8 $9 $A $B $C $D $E $F 
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6-2-6 THE I/O LOCATION 


Keyboard Special Locations 


Location: 
Hex Decimal 


Description: 


$CO000 49152 -16384 Keyboard Data 


$C010 49168 -16368 Clear Keyboard Strobe 


Video Display Memory Ranges 
Screen Page Begins at: 
Hex Decimal Decimal 
Text/LO-RES Primary $400 1024 $7FF 2047 
Secondary $800 2048 —— - $BS$ 3071 


Primary $2000 8192 $3FFF 16383 
SEcondary $4000 16384 $5FFF 24575 


Screen Soft Switches 


Location: ica 
Hex Decimal ' Description: 
$C050 49232 *-16304 Display a Graphic mode. 
$C051 49233 -16303 Display TEXT mode. 


$CO052 49234 -16302 Display all TEXT or Graphic 
$C053 49235 * -16301 Mix TEXT and a HI-RES mode. 


$C054 49236 -16300 Display the Primary page (Page 1). 
$C055 49237 -16299 Display the Secondary page (Page 2). 


$CO56 49238 -16298 Display LOW-RES moce. 
$C057 49239 -16297 Display HI-RES moce. 


Input/Output Special Locations 


Address: , 


Cassette Out 49184 -16352 $C020 

Cassette In 40256 -16288 $CO60 

Annunciators 49240 -16296 $CO5K 3 
through through through 
49247 -16289 $CO5F 


Flag inputs 


Analog Inputs 


Analog Clear 49264 -16272 . $CO070 R/W 
Utility Strobe 449216 16320 $Cco40Ots R | 


6—2—7 THE VIDEO GENERATOR 


-16284 


49253 -16283 $CO65 
49254 -16282 $CO066 
49255 -16282 $C067 


There are 192 scan lines on the video screen, grouped in 24 lines of eight scan lines each. 
Each scan line displays some or all of the contents of forty bytes of memory. 


The video generation circuity dervies its synchronization and timing signals from a chain of 
74LS161 -counters at board locations D11 throug. D14. These counters generate fifteen 
synchronization signals: 


HO Hl H2 H3 H4 H5 
vo vl V2 V3 V4 
VA VB vc 


The “H”’ family of signals is the horizontal byte position on the screen, from 000000 to* 
binary 100111 (decimal 39). The signals VO through VO through V4 are the vertical line 
position on the screen, from binary 0000 to binary 10111 (decimal 23). The VA, VB, arid VC 
signals are the vertical scan line position within the vertical screen line, from binary 000 to 
111 (decimal-7). 


These signals are sent to the RAM address multiplexer, which turns them into the address of a 
single RAM location, dependent upon the seting of the video display mode soft switches. 
The RAM multiplexer then sends this address to the array of RAM memory during ®1. The 
latches which hold the RAM data sent by the RAM array reroute it to the video generation 
circuit. The 74LS283 rearranges the memory addresses so that the memory mapping on the 
screen is scrambled. 


6—17 


6—2-8 


If the current area on the screen is to be a text character, then the video generator will route 
the lower six bits of the data to a character generator. The seven rows in each character are 
scanned by the VA, VB, and VC signals, and the output of the character generator is 
serialized into a stream of dots by a 74166. This bit stream is routed to an exclusive-OR gate, 
where it is inverted if the high bit of the data byte is off and either the sixth bit is low or the 
555 timer at location B3 is high. This produces inverse and flashing characters. The text bit 
stream is then sent to the video selector/multiplexer (below). 


If the video. screen is in a graphics mode, then the data from RAM is sent to two 74LS194 
shift registers Here each nibble is turned into a serial data stream. These two data streams are 
also sent to the video selector/multiplexer. 


The 74LS257 multiplexer selects between Color and High-Resolution graphics displays. The 
serialized Hi-res dot stream is delayed one-half clock cycle by the 74LS74 at location A11 if 
the higs bit of the byte is set. This produces the alternate color set in High-Resolution 
graphics mode. 


The video selector/multiplexer mixes the two data streams from the above sources according 
to the setting tothe video screen soft switches. The 74L194 and the 74LS151 select one of 
the serial bit streams for text, color graphics, or high-resolutiorr graphics depending upon the 
screen mode. The final serial output is mixed with the composite synchronization signal and 
the color burst signal generated by the video sync circuits, and sent to the video output 
connectors. 


The video display soft switches, which control the video modes, are decoded as part of the 
on-board |/O functions. The more detail information is shown in Table 6—3. 


The color burst signal is created by logic gates at B12, B13, and C13 and is conditioned by 
R5, coil L1, C2, and trimmer capacitor C3. This trimmer capacitor can be tuned to vary the 
tint of colors produced by the video display. Transistor Q6 and its companion resistor R27 
disable the color burst signal when the BASE is displaying text. 


VIDEO OUTPUT JACKS 


The vidoe signal generated by the aforementioned circuitry isan NTSC compatible, similar to 
an EIA standard, positive composite video signal which can be fed to any standard closed- 
circuit or studio video monitor. This signal is available in three places on the board: 


RCA Jack. On the back of the BASE board, near the right edge, is a standard RCA phono 
jack. The sleeve of this jack is connected to the common ground and the tip is connected to 
the video output signal through a 200 Ohm potentiometer. This potentiometer can ajust the 
voltage on this connector from 0 to 1 volt peak. 


Auxilany Video Connector. The connector is illustrated in figure 6—6 ' 


Table 28: Auxiliary Video Output Connector Signal Descriptions 


Audio Sound: 


GROUND System common ground; 0 volts. 


VIDEO NTSC compatiable positive composite video. Black level is 
about .75 volt, white level about 2.0 volt, sync tip level is 0 


volts. Output level is not adjustable. This is not protected 
against short circuits. 


+12 volt power supply. 


—5 volt line from power supply. 


Auxillary Video Pin. This single metal wire-wrap pin below the Auxiliary Video Output 
Connector supplies the same video signal available on that connector. It is meant to be a 
connection point for PAL/SECAM encoder boards. 
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Figure 6—6 Auxiliary Video Output Connector and Pin. 


6—2—9 THE GAME 1/0 CONNECTOR 


BLAS eT. +5v 1 

Roto 1 PBO Z NC 
yviOlEIAr PB1 2 NC 
HARRon PB2 |4 NC 
C040 STROBE |5 NC 

4 GCO 6 GC3 2 vEKD 

ie A 2 GCZ |7 GC1 4) gu 
tases Fe Gnd {8 NC 

Game |!/O Connector Pinouts 
Hemsra CANON e 


GCA we GND +SV KE 


Description: 


+5 volt power supply. Total current drain on this pin must 
be less than 100mA. 


PBO-PB2 Single-bit (Pushbutton) inputs. These are standard 74LS 
series TTL inputs. 


C040 STOBE A general-purpose strobe. This line, normally high, goes low 
during ¢0 of a read or write cycle to any address from 
$CO40 through $CO4F. This a standard 74LS TTL output. 


6,7,1011 GCO-GC3 Game ‘controller inputs. These should each be connected 
through a 150K ohm variable resistor to +5v. 


8 Gnd System electrical gound. 


9,12—16 NC No internal connection. 


—2—10 CASSETTE INTERFACE JACKS 


The two female minature phone jacks on the back of the BASE board can connect your 
BASE to normal home cassette tape recorder. , 


Cassette Input Jack: This jack is designed to be connected to the “Earphone” or “Monitor” 
output jacks on most tape recorders. The input voltage should be 1 volt peak-to peak 
(nominal). The input impedance is 12K Ohms. 


Cassette Output Jack: This jack is designed to be connected to the ‘’Micropnone” input on: 
most tape recorders. The output voltage is 25mv into a 100 Ohm impedance load. 


6—2—11 KEYBOARD CONNECTOR 


The data from the BASE’s keyboard goes directly to the RAM data multiplexers and latches, 
the two 74LS257s at locations B6 and B7. The STROBE line on the keyboard connector 
sets a 74LS74 flip-flop at location B10. When the I/O selector activates its ‘‘O’’ line, the data 
which is on the seven inputs on’the.keyboard connector, and the state of the strobe flip- 
flop, are mulitplexed onto the BASE’s data ‘bus. 
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Keyboard Connector Signal Descriptions 


Description: 


+5 volt power supply. Total current drain on this pin must 
be less than 120mA. 


STROBE Strobe output from keyboard. This line should be given a 
pulse at least 10us long each time a key is pressed on the 
keyboard. The strobe can be of either polarity. 


RESET Microprocessor’s RESET line. Normally high, this line 
should be pulled low when the REST button is pressed 


4,9, 16 NC No connection. 
| 5-7, 10-13 Data Seven bit ASCII keyboard data input. 


8 System electrical gound 


15 —12 volt power supply. Keyboard should draw less than 
500mA. 


Keyboard Connector Pinouts 


6—2—12 POWER CONNECTOR 


This connector mates with the cable from the BASE Power Supply. This 5-pin male 
connector. 


Power Connector Pin Destriptions 


Description: 


Ground Common Electrical ground for BASE board. 


+5.0 Volts from power supply. An BASE with 64K of RAM 
and no peripherals draws — 1.5 amp from this supply. 


+12.0 volts from power supply. An BASE with 64K of 
RAM and no peripherals draws — 400 ma from this'supply. 


—12.0 volts from power supply. An’ BASE with 64K of 
RAM and no peripherals draws — 12.5 ma from this supply. 


—5.0 volts from power supply. An BASE WITH 64K OF 
RAM and no peripherals draws — 0.0 ma from this supply. 


1 

e +5v 

2 

@ —12v 

3 

e +5v 

a 

e +12v_ 
GND 


6—2—13 SPEAKER 


The BASE’s internal speaker is driven by half of a 74LS74 ‘flip-flop through a Darlington 
amplifier circuit. The speaker connector is a Molex KK100 series connector, with two 


square pins. .25”’ tall, on .10”’ centers. 


Speaker Connector Signal Descriptions 


Description: 


Speaker signal. This line will deliver about .5 watt into an 8 
Ohm load. 


+5 volt power supply 
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Speaker Connector 


6—3 THE PERIPHERAL 


6—3—1 PERIPHERAL CARD 1/0 SPACE | 
Each slot is given.sixteen locations beginning at location $CO80 for general input and output 
purposes. For slot 0, these sixteen locations fall in the memory range $CO80 through | 


$CO8F; for slot 1; they’re in the range $CO90 through $CO9F etc. Each peripheral card 

can use these locations as it pleases. Each peripheral card can determiné when it is being T: 
selected by listening to pin 41 (called DEVICE SELECT) on its peripheral connector. 

Whenever the voltage on this pin drops to 0 volts, the address which the microprocessor is [ 
calling is somewhere in that peripheral card‘s 16-byte allocation. The péripheral.card can’ . — 
then look at the bottom four address lines to determine which of its sixteen addresses is 
being called. . 


Peripheral Card 1/O Locations 


$0 $1 $2 $3 $4 $5 $6 $7 $8 $9 $A $B $C $D $E $F 


InPut/OutPut for slot number 


6—3—2 PERIPHERAL CARD ROM SPACE 


}——} 


Each peripheral stot also has reserved for it one 256-byte page of memory. This page is 
usually used to house 256 byte of ROM or Programmable ROM (PROM) memory, which 
contains driving programs or subroutines for the peripheral card. In this way, the peripheral 
interface cards can be “‘intelligent’’: they contain their own driving software; you do not 
need to load separate programs in-order to use the interface cards. 


| 
_., 


The page of memory reserved for each peripheral slot has the page number $Cn, where n is 
the slot number. Slot 0 does not have a page reserved or it, so you cannot use most BASE 
interface cards in that slot. The signal on Pin 1 (called 1/O SELECT) of each peripheral slot 
will become active (drop from +5 volts to ground) when the microprocessor is referencing an 
address withing that slot’s reserved page. Peripheral cards can use this signal to enable their 
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PROMs, and use the lower eight address lines to address each byte in the PROM. 
~ Peripheral Card PROM Locations 


$00 $10 $20 $30 $40 $50 $60 $70 $80 $90 $A0 $B0 $CO $DO $EO $FO 


PROM space for plot number 


1 
2 
3 
& 
5: 
6 
7 


6—3—3 PERIPHERAL CONNECTORS 


The eight peripheral conectors along the back edge of the BASE’s board are Winchester 
#2HW25C0-111 .50-pin PC card edge connectors with pins on .10” centers. The pinout for 
these connectors is given in Figure 6—7, and the signal. descriptions are given on the 
following pages. ; 
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GND 

DMA IN 

INT IN 

NMI 

IRQ 

RES 

INH 

—12V 

—5V 

(OR REF ) N.C. 
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Figure 6—7 Peripheral Conneotor Pinout 
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1/O STROBE 
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Peripheral Connector Signal Description 


Description: 


1/0 SELECT This line, normally high, will become low when the 
microprocessor references page $Cn, where n is the in- 
divdual slot number. This signal becomes active during &0 : 
and will drive 10 LSTTL loads*. This signal is not present 
on peripheral connector 0. 


2-17 A0-A15 The buffered address bus. The address on these lines 
becomes valid durint @1 and remains valid through #0. 
These lines will each drive 5 TTLX loads. 


Buffered Read/Write signal. This becomes valid at the same, 
time the address bus does, and goes high during a read cycle 
and low during a write. This line can drive up to 2 LSTLL 
load*. 


SYNC On peripheral connector 7 only, this pin is connected to the 
video timing generator’s SYNC signal. 


1/0 STROBE This line goes low druing #0 when the address bus contains 
an address between $C800 and $CFFF. This line will drive 4 
LSTTL loads*. 


The 6502’s RDY input. pulling this line 10 during #1 will 
halt the microprocessor, with the address bus holding the 
address of the current location being fetched. 


Pulling this line low disables te 6502's address bus and halts 
the microprocessor. This line is held high by a 3KQ resistor 
to +5v. ; 


INT OUT Daisy-chained interrupt output to lower -priority devices. 
This pin is usually connected to pin 28 (INT IN)v 


DMA OUT Daisy-chained DMA output to lower priority devices. This 
pin is usually connected to pin 22 (DMA IN). 


+5yv +5 volt power supply. 500mA current is available for all 
peripheral cards. 


GND System electrical ground. 


DMA IN Daisy-chained DMA input from higher priority devices. 
Usually connected to pin 24 (DMA OUT). 


INT IN Daisy-chained interrupt input from higher priority devices. 
Usually connected to pin 23 (INT OUT). 
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42-49 


COLOR REF 


7M 


Q3 


@1 


60 


DEVICE 
SELECT 


DO-D7 


Description: 


Non-maskable Interrupt. When this line is pulled low the| 
BASE-begins an interrupt cycle and jumps to the interrupt 
handling routine at location $3FB. 


Interrupt Request. When this line is pulled low the BASE 
begins an interrrupt cycle only if the 6502's | (Interrupt 
disable) flag is not set. If so, the 6502, will jump to the 
interrupt handling subroutine whose address is stored in 
locations $3FE and $3FF. 


When this line is ‘pulled low the microprocessor begins a 
RESET cycle (see page 36). 


_ When this line is pulled low, all ROMs on the BASE board 


are disabled. This'line is held high by a 3KQ resistor to +5v. 


— 12 volt power supply. Masimum current is 200mA for all 
peripheral boards. 


—5 volt power supply Maximum current is 200mA for all 
peripheral boards. 

On peripheral connector: 7 only, this pin is connected the 
3.5MHz COLOR REFerence signal of the video generator. 


7MHz clock. This line will drive 2 LSTTL loads*. 


2MHz asymmetrical clock. This line will drive 2 LSTTL 
loads*. 


Microprocessor’s phase one clock. This line will drive 2 
LSTTL loads*. 


This line, when pulled low, disables all internal 1/O address | 
decoding**. 


Microprécessor’s phase zero clock. This line will drive 2 
LSTTL loads*. | 


This line becomes active (low) on each peripheral connector 
when the address bus is holding an address between $COn0 
and $COnF, ‘Where n is the slot number plus $8.' This line 
will drive 10 LSTTL loads*. 


Buffered bidirectional data bus. The data on this line 
becomes valid 300nS into ®0 on a write cycle, and should 
be stable no less than 100ns before the end of 0 on a read 
cycle Each dataline can drive one LSTTL load. 


+12 volt power supply. This can supply up to 250mA total | 
for all peripheral cards. 
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Mini-Witer has two major program:|the ‘editor program and the printer program, in this chapter we will 
show you how to use it. , 


When you want to use Mini-Writer you should do the following procedure: 


BASE-64A 


]WRITER| RETURN 


then you will enter the editor program of Mini-Writer. 


7—1 THE EDITOR 


a 


Se 


LL) ee ee ees) ke! SK 


as you look at the screen, you see the six options on the menu. Look at all of them before selecting 
one. If you select the first option, (E) EDIT FILE IN MEMORY, you may insert, delete, and modify 
the text in your BASE’s memory. (N) INITALIZE NEW FILE clears the memory so you can enter a 
new text file. you tried that option when you practice stopping, so you know it will ask you. if you 
want to save the file in memory. 


(L) LOAD FROM DISK allows you to load a text file from the diskette into the BASE’s memory. If 
you press L, the Mini Writer responds 


“ENTER FILE NAME: 


or, if you've used the editor program without quitting, it remembers-the name of the file you last 
loaded or saved any responds. 


USE “YOUR FILE’S NAME” 
AS FILE NAME (Y/N)? 


This reminds you that you have a-file in memory, which the Mini Writer will erase when it loads a new 
file from the diskette. This would be a good time to save on a diskette the current version of the file in 
memory. After saving your file, start the process of loading again. Press L in response to the menu, 
then N in response to the “use file name” question. The Mini Writer responds 


ENTER FILE NAME: 


If you enter the name of a nonexistent file or mistype the file name, the Mini Writer displays the 


message 


FILE NOT FOUND 

then, returns to the menu. 

To back out of loading a file, press R ETURN in response to 

ENTER FILE NAME: | 

(S) SAVE TO DISK save on a diskette the contents of the text file in memory. 


(P) PRINT FILE starts the second half of the Mini Writer working -- printing your text on paper. 


7-1 


Finally, (Q) QUIT returns you to BASIC. 
Now, try the first option. When you press E, your message, 


GOOD MOORNING, CLASS. 


_ should appear on the screen. For the moement that’s all the text you want, so return to the menu. 


Remember that you type ECS CTRL-Q to return to the menu. | 


7-1-0 SAVE YOUR TEXT FILE ON TAPE, AND LOADING A TEXT FILE FROM TOPE 


After you edit your text file, be sure to SAVE the edited version. If you didn’t have disk 
drive, you still can save your file, use the tape recorder, when you back to BASIC then: 


JCALL-151 

*1900, 3900 W ; your file will save in tape! when you want to load you file into 
Mini-Writer’s buffer: 

*1900. 3900R 

* (CTRL B) 

]WRITER 


you should use “L”’ option first, when Editor asks you the file name give him a name whether this file 
is exist Or not, then you can use ‘’E”’ option to edit you file. 


7-1-1 SAVING YOUR TEXT FILE 


Look over the options on the menu. Press S to indicate that you want to save your file on a 
diskette. If you have not named your file before, the Mini Writer will respond with 


ENTER FILE NAME: 


At this point, you need to name your file. The maximum length of a file name is 22 
characters, including spaces. See the DOS manual for more information on file names. 


Choose and enter a name for the file you want to save. For éxample, if you name your file, 
“’Class’’, type 


CLASS 
Be sure to initialize diskettes before you save files on them. 


If you have saved your file before, and have used the editor program without quitting, the 
Mini-Writer responds 


USE “FILE NAME” 
AS FILE NAME (Y/N)? 


Press-Y to save the revised version under the same name. 
This erases the old version of the file from the diskette. 


If you want to save many versions, each of them must have a unique name. For example, 


a 


7- 1-2 


Letter, Letterl, Letter2, etc. 


After the disk saves the file, the editor menu will appear on the screen. indicating you need 
to select what you'll do next. 


If you decide you don’t want to save your file, you can press RETURN in response to 
ENTER FILE NAME: and USE “FILE NAME” AS FILE NAME (Y/N)?. This returns 
you to the point of selecting an option from the editor menu. 

To see which files are on a diskette or to erase files you no longer want, use CTRL-D 

If you want the file to be saved to a disk drive or controller slot other than the one you're 
using, include this information after the file name, separating the items with commas. For 
example, although you are writing and editing on disk 1, you might want to save your file 
named CLASS on disk 2. So, to save your file on disk 2, you would type 

CLASS, D2 

in response to ENTER FILE NAME: 

If the second disk is plugged into a different controller slot (e.g., slot 7), type, 

CLASS, D2, S7 

in response to ENTER FILE NAME: 


After using a different slot number, you must specify the original slot number (most often 
it’s slot 6) when you are ready to print a file. 


One way to specify the slot number is to use CTRL—D and the Catalog command. 


CTRL—D and press RETURN 


_ Type 


CATALOG, S6 

After the screen displays the catalog for slot 6, type 

Q and press RETURN 

This takes you back to the editor menu. 

THE CURSOR 

The white blinking rectangle at the end of the menu, after SELECT:, is called the ‘’cursor’’. 
It leads you through the text, indicating where you are, not only in the text you type, but . 


also in the various modes of the mini Writer. 


You can see what the mode is by looking at the cursor. Sometimes the rectangle is blank, 
sometimes it has another character inside it (e.g., +,) 


LL 


OO 
7-1-3 STOPPING AND RESTARTING 


_ The purpose here is to show you how to get in and out of text files. Once you have delved 
into the mysteries of the Mini Writer and are entering text, you may want to stop for a 
while (e.g., for eating, sleeping, or buying more diskettes).|Here is an example of stopping 
after you have typed a text file. 


The first thing to do is to set the scene for stopping. Before you can stop you must start 
editing. Do this by getting the editor menu on the screen. (If you have been following the 
examples in this manual, the editor menu should be on the screen.) Type N in response to 
the menu. 


7—2 MODES OF CURSOR 


The Miri Writer operates in two modes. By looking at the cursor, you can tell which mode the mini 
Writer is using. , 


Cursor: Mode: To enter from To exit, press: 
text mode, press: 


0 Text mode _ (Default) 
* Cursor control mode ESC space bar (to get []) 


; ; 
“Default” indicates the condition that exists when you first start using the mini Writer. For example, 
the editor program always starts in text mode, which is the default mode for the mini Writer. 


7—2-—1 TEXT MODE 


When you select E from the editor menu, you automatically get text mode. In this 
mode, you may enter and delete words; move letters, words, or lines around the screen 
(or the file); or review the contents of the file without changing them. 


When you're entering text on the screen, the Mini Writer will wrap around when your 
text reaches the right edge of the screen, splitting your words anywhere the break occurs. 
This doesn’t affect the final document -- the text looks very nice when it comes out of the 
printer. For example, a line you type may look like this on the screen: 


Here is sample line to show wrap arou| 
nd and how it looks. 


and will print like this: 
Here is a sample line to show wrap around and how it looks. ’ 
7—2—2 CURSOR CONTROL MOCE 


In this mode, you may move the cursor around the screen without changing the text. To 
enter this mode, press ESC once. After the ESC, the cursor will change form C]to +, showing 
you that the Mini Writer is in crusor control mode, Now move the cursor around the screen, 
using the following keys: 

move the cursor around the screen, using the following keys: 


1 I 
i 


r 
} 


-— 
to 


 . 


= 
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Key: Moves curosr: 

K Right one character 
J Left one character 

| Up one line 

M Down one line 


Look at the |, J, K, and M keys on the keyboard. They look like this: 


Imagine four arrows drawn on them (or make little labels and stick them on the keys): 


Simultaneously pressing one of these keys and the [REPT key, you may meve the cursor 
rapidly across a line of text and up and down the lines of text. 


If you press some key other than CTRL-T, CTRL-V, I, J, K, or M, (or RESET), the cursor 
will revert to text mode (Cursors! Foiled again!), changing from + to blank. If you press 
RESET, you will return to the editor menu. 


As you move the cursor by pressing | (or | and the[REPT]key), you will notice that it zigzags - 
its way through the text. It moves up about 40 characters at time, unless it encounters a 
RETURN. - 


7—3 DELETION AND RETRIEVAL 


For deleting characters, words, lines or paragraphs, the Mini Writer uses 

Left arrow <— for characters, 

CTRL-W for words, and 

CTRL-X for lines and paragraphs. 

For most deletions, the Mini Writer saves the deleted characters in what's called a “storage buffer” and 
can retrieve them from that buffer and reinsert them in the text. To reinsert characters, move the 
crusor to the place you want to insert the characters, then press the right arrow Key <— . 

Deleting, then reinserting, is one technique for moving small amounts of text. 

If you press[REPLlat the same time as any of the delete keys, you will delete keys, you will delete 
characters very fast. This can cause problems if you want to retrieve those characters. Tue storage 
buffer holds only 256 characters, which is about 6 lines on the screen. 


7-3-1 CHARACTER DELETION [ <—] 


lf you make a mistake when you are typing text, you may delete unwanted characters by 
pressing the left arrow key <~ You may hold down to delete a lot of cnaracters - 


Hes 


7-3-2 


7-3-3 


7-3-4 


quickly. 
Try an example of deleting characters. Type 


I ENJOY DISCO MUSICK 


As you look at this sentence, you realize you've made a mistake. ‘Music’ doesn't end with a 
K. So you press <— to delete K. 


You look at the sentence again and realize you've made another mistake. You really don't 
like disco music. So press <—REPT to delete the whole sentence. 


CHARACTER RETRIEVAL [ — ] 


To retrive characters you have deleted, press the right arrow key -S By holding down > 
REPT} you may retrieve a lot of characters quickly 


The Mini Writer saves up to 256 deleted characters in the storage buffer from which you may 
retrieve characters once. If you continue to press the right arrow, you'll retrieve all the 
characters you've deleted, plus any leftover characters in the storage buffer. After retrieving 
256 characters, you'll start over and retrieve them again. 


Fer example, you have a change of heart and decide to retrieve your sentence about disco 
music. Hold down —> [REP Tluntil the entire sentence reappears on you screen. 


Now, press —> again and hold them down until you get several copies of your 
sentence about disco music (and any other characters in the storage buffer). 


You now have a screen full of unwanted characters, which you can delete by pressing CTRL- 


WIREPT). 


Pressing also retrieves text deleted by [CTRL-W] and CTRL-X. 


WORD DELETION [CTRL-W] 


To delete and entire work press CTRL-W. For CTRL-W, a word is a string (i.E., group of 
characters) preceded by a space. If you typed 100 continuous characters (without spaces), 
CTRL-W would define that as one word and delete them all. Specifically, CTRL-W deletes 
characters to the left of the cursor until it has deleted a space. 


‘ Since CTRL-W deletes characters preceding the cursor up to and including a space, all the 


words in the storage buffer will be separated by spaces. 


PARAG RAPH DELETION [CTRL-X] 


To delete an entire line or paragraph, press CTRL-X. This function works in much the same 
way as CTRL-W, except that it stops after deleting a RETURN (or 256 characters) rather 


than a space. 


If CTRL-X has deleted 6 lines and still hasn't encountered a RETURN, it will stop, the BASE 
will beep, and your screen will sav 


YBUFFER OVERFLOW> 


This means that the storage area for deleted characters is full, and any more deletions will 
erase some of the present contents. This also could happen with CTRL-W if you delete more 
than 6 lines of words. 


If you continue to delete text aftera BUFFER OVERFLOW, the Mini Writer adds the most 
recent word or line to the buffer and erases the oldest contents. 


If you use a RETURN at the end of each line on the screen (a bad idea if you plan to print 
your text), CTRL-X will delete only one of the lines. If you type complete paragraphs 
separated by RETURNs (a good idea if you plan to printe your text), CTRL-X will delete the 
entire paragaraph. Specifically, CTRL-X deletes characters to the left of the cursor until it has 
deleted a RETURN or 256 characters. 


7—4 MORE CUROSR CONTROL 


The Mini Writer provides four control functions for moving the cursor quickly through the text 


This character: Moves Curose: 
CTRL-B To file beginning 
CTRL-E To file end 
CTRL-T Up 12 lines 
CTRL-V Down 12 lines 


You may use all four functions in two of the modes (text ‘and upper case), but only two fo the 


function 


, CTRL-T and CTRL-V, also work in case change and cursor control mode. 


Try moving the cursor up and down in your text. Generally, if you press CTRL-T, then press CTRL-V 
without modifying your text, the cursor will be where it was before you pressed CTRL-T. 


7—5 OTHER 


7-5-1 


CONTROL FUNCTIONS 
CTRL-D: DISK ACCESS 


This function lets you use the disk operating system (DOS) from the Writer. You may use 
CTRL-D from any menu and from anywhere in the text you're editing. 


Type CTRL-D. (from a menu, you need to type CTRL-D and press RETURN.) The Mini 
Writer responds: 


====CTRL—D ENTER DISK COMMAND 
(0) = OUIT 


The next characters you type will be a command to DOS. For example, if you've forgotten 
the names of your files, type 


CATALOG 


The Mini Writer succumbs to DOS, which displays the catalog on the screen. It then asks for 
another disk command. 


7-5-2 


7-5-3 


If you want to delete a file from your diskette, type 
DELETE TEXT . FILENAME 


If you have no more commands for DOS, and want to resume editing presg Q, then press 
RETURN. 


CTRL-F: FREE MEMORY 


To allow space in memory for making changes in a long text file, you should save a long file 
before filling all of your BASE’s memory. To find out how much memory remains, press 
CTRL-F. Your BASE's will beep and a message will appear at the bottom of the screen. For 
example, if memory has space for 12,886 characters, you'll see 


<FREE MEMORY = 12886> 


Your BASE’s memory has space for 31,901 characters of text. By subtracting your files’ free 
memory from 31,901, you will Know how many characters you've written. 


CTRL-K: SAVING A FILE SEGMENT 


CTRL-K saves a copy of a segment of your file on a diskette. The segment to be saved must 
begin with a specified marker and end at the present cursor position. You may want to insert 
a distinctive marker such as & the start of the segment to be saved. Be sure to delete the 
marker when you want to print the text. 


The Mini Writer searches for the marker by starting at the cursor and searching to the 
heginngin of the text for the first occurrence of the marker. It will not search beyond the 
cursor for a marker -- you can only save segments above the cursor. 


The “marker” referred to is a character or sl that uniquely identifies the beginning of the 
segment. If you wanted to save this: 


CATS HATE BEING CATEGORIZED 

and you used “CAT” as the marker, you would only save the last word because the search 
would find the “CAT” in “CATEGORIZED”. In difficult cases, you can insert a special 
marker and remove it later. 

When you press CTRL-K, below the text on your screen, you'll see: 

==== CTRL-K TO COPY TO DISK THE 

SEGMENT BETWEEN CURSOR AND A MARKER 

ABOVE CURSOR, ENTER MARKER 

After you have entered the marker, the Mini Writer will respond with 


¥%STRING NOT FOUND> 


If it can’t find your marker, otherwise it will ask you to 


L 
. 
| 


Lal 


7-5-4 


ENTER FILE NAME: 


At this point, choose a name for your file. BESURE THE NAME IS ONE YOU HAVEN'T 
ALREADY USED. Save the file segment on a diskette. Saving a segment does not delete it 
from your text file. 


The space available on the diskette and the space available in memory are two limits on the 
length of a file segment saved on diskette. 


-Do not use the name of the file you are editing or of any other file you want to preserve on 


your diskette. If you save the segment by naming it with the name of another file, you will 
lose the entire contenDs of that other file. 


CTRL-I: INSERTING A FILE 


CTRL-I allows you retrieve a copy of a file from a diskette and add to your text. This is 
very useful for adding sections to your text and for inserting a copy of sections that occur 
often in the text. Using CTRL-I to insert a file, which might be a paragraph that you use 
frequently, you save both time and typing. 


If you think the space in memory may be running short, check by pressing CTRL-F. Also, 
before you use CTRL-I, save a backup copy of the file you're editing. Check the available 
memory. immediately after inserting a file. 


WARNING: You will mess up the contents of memory if the Mini-Writer tries to insert a 
file longer than the space available in memory. 


If you do try to insert too longa file, the ‘Mini Writer will fit in as much as it can, then 
respond 


I/O ERROR 
or 
<FREE MEMORY = 2> 


depending on where in the file it stops. After flashing the I/O ERROR message on the screen, 
it returns you to the- menu. After flashing the FREE MEMORY message, it returns you to the 
point at which the file it inserted overlaps with the file you were editing. 


AN EXAMPEL OF CTRL-I 


Save “The spotted Cow” or some text of your choice on a diskette. START A NEW FILE BY 
SELECTING N from the editor menu. Type some lines, for example: 


| must confess you're very kind, 
Very kind, said she. 

It’s there you're sure the cow to find 
Come, sweetheart, walk with me. 


Then in the grove they spent the day 
And thought it passed too soon 

At night they homeward made their way 
While brightly shone the moon. 

So if | should cross the flowery glen 

Or go and view the plow 

She'd come and call me, gentle swain, 
\‘ve lost my spotted cow. 


Move the cursor to the top of the new file (try CTRL-B). Now, press CTRL-I. The Mini 
Writer will respond with: 


====CTRL-I TO INSERT A DISK FILE AT 
THE PRESENT CURSOR POSITION. 


ENTER FILE NAME 
' Type THE SPOTTED COW 
(or the file of your choice). 


The Mini Writer will insert that file in front of the cursor, leaving the cursor at the end of this 
- newly inserted file. 


If you misspell the file name or enter the name of a nonexistent file, the Mini Writer responds 
FILE NOT FOUND 
and returns you to the editor menu. 

7-5-5 CTRL-P: POP 


Pressing CTRL-P turns on aclicker in your BASE. Each time the cursor passes over RETURN 
in the text, the BASE will make a clicking sound. Sometimes this sound is very faint. 


To stop the clicking, press CTRL-P again. 


CTRL-P can be helpful when you’re counting RETURNSs in a document you want to print. 
It tells you if you have a RETURN or a blank line that is an artifact of the BASE screen. 


7—5-6 CTRL-S: SEARCH AND REPLACE 
To view each occurrence of a string or to replace one string with another, press CTRL-S. 


At the bottom of the screen, you should see 


==== CTRL-S SEARCH & “REPLACE 


SEARCH ONLY, ENTER /AS IS/ 
SEARCH & REPLACE, ENTER /AS IS/ TO BE 


es 


CTRL-S searches. forward from the cursor position to the end of the text for a string. It 
won't find strings above the present cursor position. In many cases, before using CTRL-S, 
you may want to jump to the beginning of the text (remember CTRL-B) so you can search 
through the entire text. 


DELIMITERS. Use “delimiters” to tell CTRL-S which characters you want to find. 
Delimiters are characters that set off a string. The diagonals (/) are delimiters. Although you 
may use any character for the delimiter EXCEPT the characters in a string we recommend 
using diagonals (/). If the string you want contains diagonals, use (&) or some other little-used 
character for the delimiters. . 


SEARCHING. To search without making any changes, enter one string for example: ° 


/Show me each of these/ 
If you enter only one string, the Mini Writer will prompt 


==== CTRL-S SEARCH & REPLACE 


SEARCH ONLY ENTER HS IS 
SEARCH & REPLACE, ENTER’ HS IS TO BE 
/TEST/ 


TO CONTINUE SEARCH, PRESS RETURN 
TO EXIT, TYPE ANYTHING ELSE 


Press RETURN to start the search for the first occurrence.of the string. Each time you press 
RETURN, the Mini Writer will search for the next occurrence of the string. 


REPLACING. If you want to change some characters, enter two strings. Use delimiters to 
separate the search string from the replacement string, for example: 


/The way it is now/The way you want it/ 
If you enter both a search and a replacement string, the Mini Writer will prompt 


==== CTRL-S SEARCH & REPLACE 


SEARCH ONLY, ENTER: /AS IS/ ' 
SEARCH & REPLACE, ENTER: /AS IS/TO BE 
/PEN/PUN/ 


REPLACE (A) AUTOMATIC, OR (M) MANUAL 

Press M to replace selected occurrences of a string after looking at them, press A for 
aoutomatic replacement. 

When entering strings, beware fo these typical errors: 

* Entering only one delimiter: /TEST 


*Misplacing the delimiters in the entery: //TEST 
*Entering less than three delimiters when you want to replace a string; 


/TEST/REPLACEMENT 
This results in searching, not replacing. 


lf you make a mistake entering the strings and delimiters, the Mini Writer usually gives you 
another chance to enter them correcly. However, if you want to replace a string and you 
accidentally enter only two delimiters, the Mini Writer will start searching without replacing. 
You may quit that search by pressing the space bar. Then press CTRL-S again to start the 
process for replacing. 


REPLACING AFTER LOOKING. If you press M in response to the prompt about manual 
or automatic replacement, the Mini Writer Will respond 


==== €TRL-‘S SEARCH & REPLACE 


SEARCH ONLY, ENTER /AS IS/ 
SEARCH & REPLACE, ENTER /AS IS/TO BE/ 
/PEN/PUN/ | 

REPLACE (A) AUTOMATIC, OR (M) NANUAL 
H 


TO REPLACE, PRESS CTRL R 
TO CONTINUE SEARCH, PRESS RETURN 
TO EXIT, TYPE ANYTHING ELSE 


Press RETURN to start the search for thesfirst occurrence of the string you want to replace. 
The cursor will appear‘in front of the string to be replaced. 


To replace an occurrence of the string, press CT RAL-R. Press RETURN to search for the next 
occurence of the string. For example, using the text in the photo below, if you want to 
replace some occurrences of ‘‘pen’’ with “‘pun’’, you would specify the following string: 


REPLACING WITHOUT. SEARCHING. If you press A in response to the prompt about 
replacing manually or automatically, the program replaces strings without displaying them 
first. 


Use this conservatively. Accidents do happen when you're entering delimiters and strings. 


For example, if you use the search and replacement strings /do/does/, you'll replace ‘‘door’’ 
with ‘‘doesor’’. 


MORE NOTES ON STRINGS AND DELIMITERS. You may use upper case characters 
for the entries and may delete characters using CTRL-W, but when entering the search:and 
replacement strings, you CAN'T retrieve deleted characters with 


You may. use the null string (//) as the replacement string. This will delete the target string 
you specify and replace it with nothing (not even a blank). If you want to replace a character 
with a blank, specify / / as the replacement string. 


7-5-7 


DON’T CARE CHARACTER. You may specify some characters for a string and indicate 
that you don’t care what the other characters are. To make the don’t care character, press 
ESC then press the space bar. This will produce a character on the screen. 


CTRL-Y: MOVING. A BLOCK OF TEXT 


CTRL-Y removes a specified block of text from one place in the file and inserts it at another 
specified place. You specify markers to isolate the block you want to move and to point to 
the new location for the block. You may want to insert distinctive markers, which you delete 
after completing the move. 


For example, type- 


ALAS, POOR YORICK! 

A FELLOW OF INFINITE JEST, 
I KNEW HIM, HORATIO, 

OF MOST EXCELLENT FANCY. 


The second and third lhnes are reversed. You could use CTRL-W or CTR L-X, but that would 
be very cumbersome for larger amounts of text (e.g., if these sentences were page-long 
paragraphs). 


CTRL-Y moves blocks of any length. Place the cursor as shown: 


ALAS, POOR YORICK! 
A FELLOW OF INFINITE JEST, 


 I’KNEW HIM, HORATIO 


OF MOST EXCELLENT FANCY. 


Now press CTRL-Y. Your screen should say: 


==== CTRL-Y RELOCATE TEXT 
ENTER ORIGIN MARKER 


As with CTRL-K, the specified marker must be at the beginning of the block to be moved, 
and the cursor position marks the end. The chosen marker must be unique within the block 


for the entire block to be moved. 


Because CTRL-Y can place a block anywhere in the text, it searches th entire file for the 
marker. 


For this example, type “A” for thé origin marker. Be sure to include the space after the A 
and to capitalize the A if you used upper case when entering the text. 


After you have entered the origin marker, the Mini Writer will search from the present cursor 
position to the beginning of the file for the marker. If the Mini Writer finds the marker, 
CTRL-Y seaves the segment on a diskette under special name. 


NOTE: The special disk file name is TRANSFER FILE. This file name cannot be used for 
anything else. You may delete this file from your disk, but DON’T LOCK IT. (See the DOS 
amnual for details of locking and unlocking disk files.) 


The Mini Writer will ask you where to put the block of text by displaying: 


ENTER DESTINATION MARKER: 


Remember the block will be inserted to ‘the left of (or above) the destination marker you 
specify. That marker may be anywhere in the text file. 


For this example, use 

OF MOST 

as the destination marker. The result will be: 
ALAS, POOR YORICK! 

I KNEW HIM, HORATIO, 


A FELLOW OF INFINITE JEST, 
OF MOST EXCELLENT FANCY. 


The curser always appears at the end of the just-inserted block. 

If CTRL-Y doesn’t find the origin marker, the screen will display: 
<STRING NOT FOUND> 

and the Mini Writer will return you to your place in the text. 


To move paragraphs and their RETURNs correctly will take some practice. The cursor 
positions shown in this example will reposition lines and paragraphs correctly. 


Remember: The: BLOCK TO BE MOVED is between the present cursor position and a 
specified marker. The BLOCK DESTINATION may be ANYWHERE in the file. Therefore, 
take care in the choice of destination marker. Placing a special marker may be necessary. This 
marker is easy to delete after block has been moved, sinee-the cursor will be right next to it at 
the end of the move. 


7—6 EXTRAORDINARY CHARACTERS 


A character found on printers is the same as the character generated by BASE. In general, all the 
letters, numbers, and other characters will be printed as they appear on the BASE screen... 


When you type: You get 


on paper: 
CTRL-N ( 
ESC CTRL-N [ 


shift M ) 
ESC shift M ] 
shift N : 
ESC shift N : 


The printer you use may produce some different characters as well, so eunen with non- ereinery 
characters before using them a lot. 


7—7 RESET AND OTHER DISASTERS 


“ 


If you accidentally press RESET, you almost always return to the editor menu. or the print menu. If 
you press RESET, and see a menu on the screen, check the contents of memory before reaming 
editing, and save the memory if it’s intact. 


The possiblility exists that you may destroy some of the contents of the memory while you are editing 
if you accidentally press RESET or accidentally choose option Q from the menu. 


Whenever the screen displays a monitor or BASIC prompt character (see blow), you have left the Mini 
Writer and are in jeopardy of losing whatever you have in memory. What.you want to do is restart the 
HELLO program without destroying the memory. One way to do that is to use the following 
procedure, which preserves the file in memory: 


The screen shows: You type: 


* (monitor prompt) 3D0G (return) 
(that’s D zero G, not dog) 


] (BASIC prompt) FP (return) 
(To start BASIC again! 
RUN HELLO (return) 


This will cause the text editor program to be loaded and run. In a moment, you will be presented with 
the editor menu. Of the options on the menu, E puts the BASE text mode, preserving the present 
memory contents. Ssave the present memory contents on a diskette. N erases the memory contents, 


- allowing you to start a new file. 


Before saving the contents of memory, examine what's there to see if it's worth-saving. If memory - 


contains an edited version of an old file, DON'T save it with the old name unless you are sure that you 
want to erase the old file. 


Another remirider: If you do press N, the Mini Writer will ask 


ERASE FILE IN MEMORY (Y/N)? 


Which gives you one more chance to save the file. The Mini Writer returns to the menu if you respond ~ 


N to question about erasing the file in memory or if you press RETURN. 


lf your BASE reverts to BASIC an you choose! to abandon the file in memory and‘don’t want to. 


return to the Mini Writer, be sure to reinitials BASIC typeing FP or booting a new diskétte. 
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If you start the Mini Writer and press E in response to the editor menu before creating:or loading a 
file, you may get the message 


NO FILE IN MEMORY 


Or you may be presented with a screen full of flashing and inverse characters. Backtrack to the menu 
(ESC ESC CTRL-Q) and press N to created a new file or L to load a file. 


ANOTHER POSSIBLE DISASTER: If you have successfully loaded or created a new file and the 
screen displays lots of flashing inverse characters, the BASE may have a hardware problem. Have the 


_ system checked. 


A FINAL NOTE: It’s aaood practice to save a copy of the contents of memory frequently. 


7—8 THE PRINT PROGRAM 


The print program lets you print your text files on paper. To do that, you need a printer connected to 
the BASE’s printer controller card. 


Using the print program, you can set the format for a document in a variety of ways. You can even. 
change the fomat of a page while a file is being printed, and print one file or a series of files as a signle 
document. You may use disk commands from the print program as well as from the editor program. 


The rest of this section assumes that you have installed a printer, have connected it to your BASE, and 
are now ready to start printing, perhaps for the first time. 


7—8—1 STARTING 


We're assuming the editor program is up and running and the editor menu is on the screen. 
Select the print option from the editor menu and press P. This loads and runs the print 
program automatically. 


This is the “print menu’’. At this point, the only program in the memory is the print 
program; the editor program is no longer present. However, memory also contains the text 
file you last edited. 


To describe the print options, we'll follow the order of a typical operation of the print 
program. We’ll start with printing a single file, then describe printing multiple files as one 
document. 

7—8—2 LOAD FILE FROM DISK 
If the file you want to print is not in memory, press L. The print program responds: 
ENTER FILE NAME 


Type the name of the file. 


If you misspell the name, or the diskette doesn’t contain a file with the name you typed, or 
some disk error occurs, the program responds: 
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=a 


"I 
ae 


el ees ee 


By 
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i oll oe 


q 


=) 
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FILE NOT FOUND 


then returns you to the print menu. 


Now you can press L and try loading the file again. Once you have succeeded in getting the 
file into memory, you can use either the print or continue option to print the file. 


PRINT NEW DOCUMENT 


The P option is the heart of the print program. It starts the process of printing a new 
document. The printed file will begin at the top of a new page,.and, if you choose, it will 
have a heading and a page number appearing at the top of each page. 


In option P, the Mini Writer leads you through the final steps of geeting ready to print a file: 


setting the specifications for the format of your document, typing a heading, and starting the 
printer. 


PRINT CONSTANTS 


Before printing a file on paper, the print program sets up the details of the format for the 
document by referring to PRINT CONSTANT, PRINT CONSTANTS contains a set of 
specifications for the format of a standard page. Select the print new file option from the 
print menu by pressing P. 


Each specification is defined in the next section, Format Specifications. The specifications as 
shown above are designed to work for the average printer, but you may need to change them 
for your particular application. The instructions that come with your printer should tell you 
which values to substitute for the ones in PRINT CONSTANTS. 


To change any of the speciftcations, type the letter corresponding to it. For example if you 
type J, the print program will respond: 


ENTER NEW VALUE FOR J: 
Type the new value for that specification, then press RETURN. 
FORMAT SPECIFICATIONS 


This section defines each item in PRINT CONSTANTS. Using :these definitons, you can 
determine the correct numbers for PRINT CONSTANTS for your document and printer. 


(A) LEFT MARGIN sets the distance in columns from the left edge of the paper at whjch the 
printing of a line will BEGIN. Some printers (e. g., the Centronics) can’t print in column 0, so 
check your printer’s manual before specifying column 0 for the left margin. 


(B) RIGHT MAGIN sets the distance in columns from the left edge of the paper at which the 
printing of a line will END. For example, if you set the left margin at 10, and the right 
margin at 75, the printer will print each line between columns 10 and 75 inclusive. 


(C) TOP MARGIN sets the distance in linés between the printed title and page number 
(collectively called the ‘‘heading’’) and the first printed line. 


(D) BOTTOM MARGIN sets the distance in lines between the last printed line at the bottom 
of the page and the heading that begins the next printed page. 


(E) SPACES BETWEEN LINES sets the number of spaces between lines. Use 0 for single- 
spacing, 1 for double-spacing, 2 for triple-spacing, and so forth. 


(F) LINES PER PAGE sets the number of lines per page, which depends on the type of 
printer. Consult your printer’s manual if in doubt. Printers that print continuous forms rather 
than single page may have an automatic ‘‘step over’, which produces a margin at the bottom 
and top of the page. The most common numbers of lines for an 11-inch page are: 


# lines lines per page 
per inch without with 1-inch 
Step over step over 
6 66 60 
8 88 80 


(G) SINGLE PAGE (1) YES, (0) NO makes it easier to use signle-sheet printers. The print 
program stops printing at the end of each page so you can insert and align a new sheet. You 
then.press the space bar to resume printing. 


(H) DATA BIT 8 (1) SET, (0) CLEAR makes-the répresentation of the characters sent by 
BASE to the printer agree with what the printer expects to receive. Very few printers need 
this option. See Appendix B for more information and consult your printer’s manual for 
information about this option. 


(1) PAGE NUMBER(0 = DON’T PRINT) sets the number of the first page of your document. 
You may set-the page number anywhere in the range from 1 through 65535. The print 
program will print the page number at the center of the top of each page automatically, then 
increment it for each subsequent page. If you choose zero for the page number, page numbers 
won't be printed. If you enter a heading (see below), the page naubmer is printed after it, 


separated by a space. 


This option is very useful if you need to print a document in sections. You may reset the 
page number to start at any page in a document, e. g., page 256. 


(J) PRINTER ADDRESS tells the program which BASE slot contains the card that controls 
the printer. It sets a hexadecimal address (the ‘‘$’’ indicates this): To choose the address 


For Use 
Slot # Address ($CNOO) 


$C100 
$C200 
$C300 
$C400 
$C500 
$C600 
$C700 


NOOB WN — 
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When you change this number, don’t type the ‘’$” sign. Check the menu after you have 
entered a new address to make sure it is correct. 


Some printing situations may require an address not listed above. Two examples are the 
Centronics 779 printer, which uses $CNO2 for its printer address, and loading a driver (printer 
controller program), which uses $300 as its printer address. 


If you use the wrong address, the print program will search in vain for that address until you 
press RESET. 


PAGE HEADING 


After you have set the specifications for the format, the print program will ask you to enter a 
page heading. This is a option. The heading may be up to 60 characters long. The heading 
you use page numbers). You may use upper case letters in the heading just as in the editor 
program; however. Enter the heading or press RETURN if you don’t want a heading. 


STARTING THE PRINTER 


As soon as you enter the heading, or press RETURN, the print program is ready to start the 
printer. 


You may want take this moment to look over the printer and its connection to the BASE. Is 
the printer on? Does it have enough paper for your document? Is the paper set so the print 
will appear on the page where you want it? 


You may either run the printer or not. If you decide at the point you aren't ready to run the 
printer, press ESC to return to the print menu. If you press RETURN, the print program 
immediately starts the printer. 


When you press the RETURN key, the screen should go blank for a couple of seconds, then 
you may see streams of unreadable text pouring across the screen (ves, this is ok!) at wuich 
point the printer should start printing. 


STOPPING THE PRINTER 


If you must stop the printer, press the ESC key. When the printer reaches the end of the line 
it’s printing, it will stop and return the BASE td the print menu. Some printers store more 
than one lines worth of characters in a buffer--they'll print until the buffer is empty. 


OTHER PRINT MENU OPTIONS 


(C) CONTINUE PRINTING will print many files as one document. Use option C when your 
document is written in several files because it is too long to fit into memory all at once (e.g., 
is longer than about 16 pages). 


For example, if you have two files that you want to print as one document, print the first 
one using the P option. When this is done, load the next file, using the L option. Using option 
L will NOT cause a loss of the printing position on the page or the page number. Use the C 
option to continue printing. Printing will pick up at the line below where it left off. You can 
repeat the sequence of L and C options any number of times. 


If you don't use page numbers in your document, you can use C to print multiple copies of 
the same document, as long as you end the text.file with !np. However, if your document has 
page numbers, use option P to print multiple copies. 


(R) RETURN TO EDITOR loads and runs the editor program. The BASE Writer erases the 


print program from memory, but preserves the text file currently in memory. 


(Q) QUIT stops the print program and the BASE returns to BASIC. 


SUMMARY OF PRINT OPTIONS: To print a document, first use the L option to load the 
text file, then use the P option to print it. If the document to be printed is in several files, use 
the C option to continue printing. Use the R option to return to the editor and the O option 
to quit and return to BASIC. 


7-8-10 TEXT-EMBEDDED PRINTER COMMANDS 


To change the format of a page while it’s being printed, you can insert characters in the 
body of the text, which the print program interprets as instructions for reformatting the 
page. These characters are clled ‘‘text-embedded printer commands”. The commands 
themselves are not printed. 


The commands can change the margins (left, right, top, and bottom) and the number of 
spaces between lines; justify the print to the left, right, or center of the page; and make the 
printer move to a new page. 


Text-embedded printer commands override the specifications in print constants. To change 
a value back to what you specified in print constants, you must use another text-embeded 
printer command. 

FORMAT 

The format of command is: 


!(command) (number) 


Each command must appear on a line by itself--that is, the command must be preceded and 
followed by a RETURN. For example, to change the left margin to column 12, you would 


type 
RETURN! 1m12RETURN 


If you type a valid command using the correct format, the print program will execute the 
command and will print only the RETURN preceding the command. The line containing the 
command and its RETURN’ won't be printed. The comments most often appear at 
paragraph breaks where you want a RETURN. 


If you use incorrect format, then the command WILL be printed because the print program 
will treat the.command just like any other text. 


7—20 


ey 


The format is INCORRECT if the command has: 
*spaces or other characters between the first RETURN and the exclamation point, or 


*spaces between the exclamation point and the command, or 
*any character entered in upper case (black on white as you look at it on the screen). 


If the format is correct but the command itself is INVALID, the print program will print the 
command. 


7—8—11 SUMMARY OF COMMANDS 


Text-embedded printer commands overide the numbers-assigned to the specifications in 
PRINT CONSTANTS. You may insert the commands at any point in the text. 

Type a command at the beginning of your text to set the mode for justifying the page. Type 
commands later in the text to change any of the specification in PRINT CONSTANTS or to 
get a new page. The following table lists the commands and what they do. 


COMMAND: SETS: 

lam (number) Left margin to column (number) 
Irm (number) Right margin to column (number) 
Itm (number). Top margin 

!bm (number) Bottom margin 

Isp (number) Number of spaces between lines 
I fj. Fill justify mode 

11j Left justify mode 

Icj Center justify mode 

fj Right justify mode 

Inp A new page 


If you don’t enter a number in the commands for margins and for spaces between lines, the 
print program will use a default of 0. That is, if you use !Im as a command, the margin will 
be set to column 0. 


7—8—12 JUSTIFY MODES 


To “‘justify’’ your text, the print program aligns the printed text along the left or right 
margin, or centers it on the page, depending on which justify mode you tell it to use. 


LEFT JUSTIFY MODE is the default mode for the Mini Writer. It aligns the left edge 
‘of the printed page, so it looks muce like a page typed on a typewriter. Left justify fills 
the line, but does not pad the line with spaces. Then left justify pushes the line to the left 
until the line is flush with the left margin. This document is printed in left justify mode, 
which is less formal than fill justify. 


FILL JUSTIFY MODE both “fills’’ and justifies each line. To “fill” the line, the print 
program puts as many complete words as possible between left and right margins. To justify 
the line, the print program will add extra spaces between words to make the printed line 
fit exactly between margins. Most books are printed in fill justify mode. The foJlowing 
paragraph is printed in fill justify mode. 
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When the print program comes to a RETURN in your text, Fill justify modé does not fill -— 
or justify. The print program ends the line just after the RETURN, and does not pad the : 


line with spaces. 


One thing to watch 
out for with this mode: 
Fill justify can produce 
somewhat strange re- 
sults if it is required to 
cram many very large 
words into narrow 
margins. Since the print 
program doesn’t know 
how’ to __ hyphenae 
words, it is stuck with 
trying to fit as many 
as it can on one line, 
and ends up stuffing 
many spaces in 
between the big words, 
which can make your 
prose look very poetic, 
but maybe not too 
understandable. 


RIGHT SUSTIFY MODE does the same things as left justify. except right justify pushes 
each line to the right margin. 


CENTER JUSTIFY MODE centers a printed line between the left and right margins 
(again, without padding spaces). You might use center justify to center a title. 


Here is a demonstration of left, center, and right justify modes: 


( 
Left Justify: 


Now 

that we 

have seen the 

manner of the sky 

in the path of a storm 

we might then heed such signs 
as might be provided us from less 
sunlit places. Places not told 
of in reports of weather 

or signs of rain might 

give us portent 

all the 

same. 
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Center Justify: 


Now 
that we 
have seen the 
manner of the sky 
in the path of a storm 
we might then heed such signs 
as might be provided us from less 
sunlit places. Places not told 
of in reports of weather 


or signs of rain might 
give us portent 
all the 
same. 
Right Justify: 
N 
that we 


have seen the 

manner of the sky 

in the path of a storm 

we might then heed such signs 
as might be provided us from less 
_ sunlit places. Places not told 
of in reports of weather 

or signs of rain might . 

give us portent 

all the 

same. | 


UNPRINTED COMMENTS IN THE TEXT 


You can use text-embedded printer commands to include comments that won't be printed 
in your text. To do this, type a command but stop before you type the final RETURN : 
and insert your comment before that RETURN. ' 


The total length of the comment and the command must be less than the length of the 


printed line. If the right margin is 79 and the left margin is 7, you may use no more than 
72 characters for both the comment and the command: 
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Appendix A: ERROR MESSAGE OF BASIC 


After an error occurs, BASIC returns to command level as indicated by the ] prompt character and a flash- 
ing cursor. Variable values and the program text remain intact, but the program can not be continued and 
all GOSUB and FOR loop counters are set to 0. 
To avoid this interruption in a running program, the ONERR GOTO statement can be used, in conjunc- 
tion with an error-handling routine. | 


When an error occurs in an immediate-execution statement, no line number is printed. 
Format of error messages: 

Immediate-execution Statement ?XX ERROR 

Deferred-execution Statement ?XX ERROR IN YY 
In both of the above examples, “XX” is the name of the specific error. “YY"’ is the line number of the 
deferred-execution statement where the error occurred. Errors in a deferred-execution statement are not 
detected until that statement is executed. 


The foliowing are the possible error codes and their meanings. 


CAN’T CONTINUE 


/ 


Attempt to continue a program when none existed, or after an error occurred, or after a line was deleted < 


from or added to a program. 
DIVISION BY ZERO 
Dividing by zero is an error. 
ILLEGAL DIRECT 


You cannot use an INPUT, DEF FN, GET or DATA statement as an immediate-execution command. 


ILLEGAL QUANTITY 


The parameter passed to a math or string function was out of range. ILLEGAL QUANTITY errors can 

occur due to: 

a) a negative array SUBSCRIPT (e.g., LET A(—1)=0) 

b) using LOG with a negative or zero argument. 

c) using SOR with a negative argument. 

d) AB with A negative and B not an integer. 

e) Use of MID$, LEFT$, RIGHT$, WAIT, PEEK, POKE, TAB, SPC, ON.....GOTO, or:any of the 
graphics functions with an improper argument. 


. NEXT WITHOUT FOR 


The variable in a NEXT statement did not correspond to the variable in a FOR statement which was still 
in effect, or a nameless NEXT did correspond to any. FOR which was still in effect. 


OUT OF DATA 


A READ statement was executed but all of the DATA statements in the program had already been read. 
The program tried to read too much data or insufficient data was included in the program. 


OUT OF MEMORY 


Any of the following can cause this error: program too large; to many veriables; FOR loops nested more 
than 10 levels deep; GOSUB’s nested more than 24 levels deep; too complicated an expression; parentheses 
nested more than 36 levels deep; attempt to set LOMEM: too high; attempt to set LOMEM: lower than 
present value; attempt to set HIMEM: to low. 


FORMULA TO COMPLEX 
More than two statements of the form IF ‘’XX’’ THEN were executed. 


OVERFLOW 


The result of calculation was too large to be represented in BASIC’s number format. If an underflow 
occurs, zero is given as the result and execution continues without any error message being printed. 


REDIM'’D ARRAY 


After an array was dimensioned, another dimension statement for the same erray was encountered. This 
error often occurs if an array has been give the default dimension 10 because a statement like A(I)=3 
is followed later in the program by a DIM A(100). This error message can prove useful if you wisht to 
discover on what program line a certain array was dimensioned: just insert a dimension statement for that 
array in the first line, RUN the program, and BASE will tell you where the original dimension statement 
is. 

RETURN WITHOUT GOSUB 

A RETURN statement was encountered without a corresponding GOSUB statement being executed. 
STRING TO LONG 

Attemp was made by use of the concatenation operator to create string more than 255 characters long. 
BAD SUBSCRIPT | 

An attempt was made to reference an array element which is outside the dimensions of the array. This 
error can occur if the wrong number of dimensions are used in an array reference; for instance, LET A 
(1, 1, 1}=Z when A has been dimensioned using DIM A(2, 2). 

SYNTAX ERROR 

Missing parenthesis in an expression, illegal character in a line, incorrect punctuation, etc. 

TYPE MISMATCH 


The left-hand side of an assignment statement was a numeric variable and the right-hand side was a string, 
or vice versa; or a function which expected a string argument was fiven a numeric one or vice versa. 


UNDEF’D STATEMENT 
An attempt was made to GOTO, GOSUB or THEN to a statement line number which does not exist. 
UNDEF’D FUNCTION 


Reference was made to a user-defined fuction which never been defined. 


Appendix B: THE 6502 INSTRUCTION SET 


The following notation applies to this summary: 


A Accumulator 

x ¥ Index Registers 

M Memory 

P Processor Status Register 
S Stack Pointer 

J Change 

_ No Change 

+ Add 

A Logical AND 

- Subtract 

ye Logical Exclusive OR 
‘i Transfer to Stack 

4 Transfer to Stack 

. Transfer to 

* Transfer to 

V Logical OR 

PC Program Counter 

PCH Program Counter High 
PCl. Program Counter Low 
OPER OPERAND 

# IMMEDIATE ADDRESSING MODE: 


cooe 


CHO HH 


PROGRAMMING MODEL 6502 


* Solid line indicates currently available features. 


1/O REGISTERS 
ACCUMULATOR 
INDEX REGIS Ee Y 
INDEX REGISTER X 
PROGRAM COUNTER 


STACK POINTER 


PROCESSOR STATUS REGISTER, 


CARRY 

ZERO 

INTERRUPT DISABLE 
DECIMAL MODE 

BREAK COMMAND 
FORTHCOMING FEATURE 
OVERFLOW’ . 
NEGATIVE 


ADC 
AND 
ASL 


BCC 
BCS 
BEQ 
BIT 

BMI 

BNE 
BPL 
BRK 
BVC 
BVS 


CLC 
CLD 
CLI 
CLV 
CMP 
CPX 
CPY 


DEC 
DEX 
DEY 


“EOR 
INC. 
- INX 
INY 


JMP 
JSR 


LDA 
LDX 
LDY 
LSR 
NOP 


ORA 


INSTRUCTION ADDRESSING 
MODES AND 


RELATED EXECUTION TIMES 


Add Memory to Accumulator with Carry 
“AND” Memory with Accumulator 
Shift Left One Bit (Memory or Accumulator) 


Branch on Carry Clear 

Branch on Carry Set 

Branch on Result Zero 

Test Bits in Memory: with Accumulator 
Branch on Result Minus 

Branch on Result not Zero 

Branch on Result Plus 

Force Break 

Branch on Overflow Clear 

Branch on Overflow Set 


Clear Carry Flag 
Clear Decimal Mode 


» Clear Interrupt Disable Bit 


Clear Overflow Flag . 

Compare Memory and Accumulator 
Compare Memory and Index X 
C&6mpare Memory and Index Y 


Decrement Memory by One 
Decrement Index X by One 
Decrement Index Y by One 


“Exclusive-OR’’ Memory with Accumulator 
Increment Memory by One © 
Increment Index X by One 


Increment Index Y by One 


Jump to New Location 
Jump to New Location Saving Return Address 


Load Accumulator with Memory 

Load Index X with Memory 

Load Index Y with Memory 

Shift Right One Bit (Memory or Accumulator) 
No Operation 


“OR” Memory with Accumulator 


Push Accumulator on Stack 
Push Processor Status on Stack 
Pull Accumulator from Stack 
Pull Processor Status from Stack 


Rotate One Bit Left (Memory or Accumulator) 
Rotate One Bit Right (Memory or Accumulator) 
Return from Interrupt 
Return from Subroutine 


Subtract Memory from Accumulator with Borrow 
Set Carry Flag 

Set Decimal Mode 

Set Interrupt Disable Status 

Store Accumulator in Memory 

Store Index X in Memory 

Store Index Y in Memory 


Transfer Accumulator to Index X 
Transfer Accumulator to Index Y 
Transfer Stack Pointer to Index X 
Transfer Index X to Accumulator 
Transfer Index X to Stack Pointer 
Transfer Index Y to Accumulator 


nS gE wit? Moses EQS | i yy TOME TH. 
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INSTRUCTION LIST 
ALPHABETIC BY MNEMONIC 
DEFINITION OF 


INSTRUCTION GROUPS 


INSTRUCTION ADDRESSING MODES AND RELATED EXECUTION TIMES (in clock cycles) 


~ 
8 E 

ca. ao ne Bae £_.-.37% x> KEE 
SE888es es S®2e288ec5_  ,.24 28 
EgacaSs5B28 85 Egacae 3533382885 
gEcces se ases 3 ge ecee eee ates 3 
qENNNeaecEr Sig f@qENNNaeaeec Ec Sig 

ADC : 2 3 4 4 4*4*. |. 6 5*. SR Oe 6. 

AND .234. 4 4*4*. . 6 5. LDA 234.4 4°@ 6 5* 

ASL .. 5 6 OO ee ee OG LDX 2 3 44. 4* 

BCG x me we HR ce Oh cae , SPR LD¥Y . 234 4* 

BGS 2° wd, we ow a ee ee Cs LSR 2. 5 6 7 ‘ 

BEQ ......4..2.e8.. 2% . NOP Sw ew wie ik «oy Bee &. = 

Bi ass ewe 5 Ae hs ae we ORA .23 4. 4 4*4* . . 6 5*. 

BOE whe es Bh ae ee OS ss PHA Si ee 

| a a... ee PHP 3 

BPE « & & 2 Sos “wa wm we ORM 8 PLA 4 

BR. 6 36 2 tee ee NS el ee PLP dis Wee ee te Sak 4 

BVG «6. Ww este heer ot Ce, ete ok a ROL 2.56.67. 

BVS:. % « & & aw & wo: &. eee Ow ROR 2.56.67°.. 

CLC 2 ATI «os cee 2am 3. 8 

CLD 2 RTS bo eo le len Se ogc le ge Ge 

CLI 2 SBC 234. 4 4*4*. . 6 5*. 

CLV : . tc. me ae em x oa ene | 

CMP 23 4 4 4*4*. . 6 5*. SED «§ « & & oh a wx = BS 

CPX 2 3 enc Ee Me ee | i as ar ae 

CPY 23. We Saar “a: cae Me. STA 3 4 45 5 6 6 

DEG 5 « 86 @< @ 7 « « & « s 3 STX* . 3.. 44 

BE ss 2 a e's oe @ eB. a4 Slvr: a Oe ; 

BEY Occ ww ie woe Se we TAR wo 8 Ble eS 2 

EOR . 234.4 4*4*. . 65°. SAAS vip) me we 2 

ING «« & @ a @ Fi sw we ww 4 TSX 2 

BIN. 6 ee ee me Soe nek Fo ae UR a, TXA 2 

SREYO) ac Ce be - he en cae a? Ue te? dk TXS 2 

CMP so moet = Be 2 2S ce we SB TYA 2 


* Add one cycle if indexing across page boundary. 
** Add one cycle if branch is taken, Add one additional if branching operation crosses page boundary. 
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OPERATION ‘CODE INSTRUCTION LISTING 
HEXIDECIMAL SEQUENCE 


00 — BRK 

01 — ORA — (Indirect, X) 
02 — Future Expansion 
03 — Future Expansion 
04 — Future Expansion 
05 — ORA ~ Zero Page 
06 — ASL — Zero Page 
O07 — Future Expansion 
08 — PHP 

09 — ORA — Immediate 
OA — ASL — Accumulator 
OB — Future Expansion 
OC — Future Expansion 
OD — ORA — Absolute 
OE — ASL — Absolute 

OF — Future Expansion 
10 — BPL 

11 — ORA — (Indirect), Y 
12 — Future Expansion 
13 — Future Expansion 
14 — Future Expansion 
15 — ORA = Zero Page, X 
16 — ASL — Zero Page, X 
17 — Future Expansion 
18 —CLC 

19 — ORA — Absolute, Y 
1A — Future Expansion 
1B — Future Expansion 
1€ — Future Expansion 
1D — ORA — Absolute, X 
1E — ASL — Absolute, X 
1F — Future Expansion 
20 — JSR 

21 — AND ~ (Indirect, X) 
22 — Future Expansion 
23 — Future Expansion 
24 — BIT — Zero Page - 
25 — AND — Zero Page 
26 — ROL — Zero Page 
27. — Future Expansion 
28 — PLP 
29 — AND — Immediate 
2A — ROL — Accumulator 
2B — Future Expansion 
2C — BIT — Absolute 

2D — AND — Absolute 
2E — ROL — Absolute 
2F — Future Expansion 
30 — BMI 

31 — AND — (Indirect), Y 
32 — Future Expansion 
33. — Future Expansion 
34 — Future Expansion 
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35 — AND — Zero Page, X 
36 — ROL — Zero Page, X 
37 — Future Expansion 
38 — SEC 

39 — AND — Absolute, Y 
3A — Future Expansion 
3B — Future Expansion 
3C — Future Expansion 
3D — AND — Absolute, X 
3E — ROL — Absolute, X 
3F — Future Expansion 
40 — RTI 

41 — EOR — (Indirect, X) 
42 — Future Expansion 
43 — Future Expansion 
44 — Future Exapnsion 
45 — EOR — Zero Page 
46 — LSR — Zero Page 
47 — Future Expansion 
48 — PHA 

49 — EOR — Immediate 
4A — LSR — Accumulator 
4B — Future Expansion 
4C — JMP — Absolute 

4D — EOR — Absolute 
4E — LSR — Absolute | 
4F — Future Expansion 
50 — BVC. 

51 — EOR — (Indirect), Y 
52 — Future Expansion 
53 — Future Expansion 
54 — Future Expansion 
55 — EOR — Zero Page, X 
56 — LSR — Zero Page, X 
57 — Future Expansion 
58 — CLI 
59 — EOR — Absolute, Y 
5A — Future Expansion 
5B — Future Expansion 
5C — Future Expansion 


5D — EOR — Absolute, X 


5E — LSR — Absolute, X 


_5F — Future Expansion 


60 — RTS 

61 — ADC — (Indirect, X) 
62 — Future Expansion 
63 — Future Expansion 
64 — Future Expansion 
65 — ADC — Zero Page, 
66 — ROR — Zero Page 
67 — Future Expansion 
68 — PLA 

69 — ADC — Immediate 


6A — ROR — Accumulator 
6B — Future Expansion 
6C — JMP — Indirect 

6D — ADC — Absolute 
6E — ROR — Absolute 
6F — Future Expansion 
70 — BVS 

71 — ADC — (Indirect), Y 
72 — Future Expansion 
73 — Future Expansion 
74 — Future Expansion 
75 — ADC — Zero Page, X 
76 — ROR — Zero Page, X 
77 — Future Expansion 
78 — SEl 

79 — ADC — Abolute, Y 
7A — Future Expansion 
7B — Future Expansion 
7C — Future Expansion 
7D — ADC — Absolute, X 
7E — ROR — Abxolute, X 
7F — Future Expansion 
80 — Future Expansion 
81 — STA — (Indirect, X) 
82 — Future Expansion 
83 — Future Expansion 
84 — STY — Zero Page 
85 — STA — Zero Page 
86 — STX — Zero Page 
87 — Future Expansion 
88 — DEY 

89 — Future Expansion 
8A — TXA 

8B — Future Expansion 
8C — STY — Absolute 

8D — STA — Absolute 

8E — STX — Absolute 

8F — Future Expansion 
90 — BCC 

91 — STA — (Indirect), Y 
92 Future Expansion 

93 — Future Expansion 
‘94 — STY-— Zero Page, X 
95 — STA — Zero Page, X 
96:—°STX — Zero Page, Y 
97 — Future Expansion 
98 —TYA 
99— ‘STA — Absolute, Y 
9A.— TXS 

9B — Future Expansion 
9C — Future Expansion 
9D — STA — Absolute, X 
9E — Future Expansion 


QF — Future Expansion 
AO — LDY — Immediate 
Al — LDA — (Indirect, X) 
A2 — LDX — Immediate 
A3 — Future Expansion 
A4 — LDY — Zero Page 


- A5 — LDA — Zero Page 


A6 — LDX — Zero Page © 
A7 — Future Expansion 
A8 — TAY 

AQ — LDA — Immediate 
AA— TAX 

AB — Future Expansion 


' AC — LDY— Absolute 


AD — LDA-— Absolute 

AE — LDX — Absolute 
AF — Future Expansion 
BO — BCS 

B1: — LDA — (Indirect), Y 
B2 — Future Expansion 
B3 — Future Expansion 
B4 — LDY — Zero Page, X 
B5 — LDA — Zero Page, X 
B6 — LDX — Zero Page, Y 
B7 — Future Expansion 
B8 — CLV 

B9 — LDA — Absolute, Y 
BA — TSX ° 

BB — Future Expansion 
BC — LDY — Absolute, X 
BD — LDA — Absolute, X 
BE — LDX — Absolute, Y 
BF ~— Future Expansion 
CO — CPY — Immediate 
C1 — CMP — (Indirect, X) 
C2 — Future Expansion 
C3 — Future Expansion 
C4 — CPY — Zero Page 
C5 — CMP — Zero Page 
C6 — DEC — Zero Page 
C7 — Future Expansion 
C8 — INY 

C9 — CMP — Immediate 
CA — DEX 

CB — Future Expansion 
CC — CPY — Absolute 

CD — CMP — Absolute 

CE — DEC — Absolute 

CF — Future Expansion 
DO — BNE 

D1 — CMP — (Indirect), Y 
D2 — Future Expansion 
D3 — Future Expansion 


D4 — Future Expansion 
D5 — CMP — Zero Page, X . 
D6 — DEC — Zero Page, X 
D7 — Future Expansion 
ps — CLD 

p9 — CMP — Absolute, Y 
DA — Future Expansion 
DB — Future Expansion 
DC — Future Expansion 
DD — CMP — Absolute, X 
DE — DEC — Absolute, X 
DF — Future Expansion 
EO — CPX — Immediate 
E1 — SBC — (Indirect, X) 
—2 — Future Expansion 
E3 — Future Expansion 
E4 — CPX — Zero Page 
E5 — SBC — Zero Page 
E6 — INC — Zero Page 

E7 — Future Expansion 


E8 — INX 
EQ — SBC — Immediate 
EA — NOP 


EB — Future Expansion 
EC — CPX — Absolute 
ED — SBC — Absolute 

EE — INC — Absolute 
EF — Future Expansion 
FO — BEQ 

F1 — SBC — (Indirect), Y 
F2 — Future Expansion 
F3 — Future Expansion 
F4 — Future Expansion 
F5 — SBC — (Indirect), Y 
F6 — INC — Zero Page, X 
F7 — Future Expansion 
F8 — SED 

FQ — SBC — Absolute, Y 
FA — Future Expansion 
FB — Guture Expansion 
FC — Future Expansion 
FD — SBC — Absolute, X 
FE — INC — Absolute, X 
FF — Future Expansion 
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Appendix C: BASE SELF-TEST 


BASE gives you a TEST function to check following items: ROM, sound, pattern, color and RAM. 
"| TEST 

When you pressing RETURN key, BASE will show you the following screen: 

PRESS ANY .KEY TO CONTINUE 


After you press 4 key BASE will start to test itself under your control, the test procedure will follow the 
following sequence: ROM, sound, pattern, color and RAM. 


]TEST 
PRESS ANY KEY TO CONTINUE 


BASE 64A ROM TEST: 
BASE 64A ROM : 01 
BASE 64A ROM :: 02 
BASE 64A ROM : 03 
BASE 64A ROM : 04 
BASE 64A ROM : 05 
BASE 64A ROM : 06 


If there has bad Rom, the BASE will display: 


NON BASE ¢4A ROM: # 
You should change the ROM to let the BASE back to normal. 


PRESS ANY KEY TO CONTINUE 

SOUND TEST: (Demo a song) 

PATTERN TEST: . 

@ABCDEFGHIJKLMNOPQRSTUVWXYZ[/] *- !“#$%&’ 
( )*+,-./0123456789:;<=>? @ABCDEFGHIJKLMNOP 
QRSTUVWXYZ[/]*- !“#$%&'( )*+#,—-./0123456789: 
oe | . 


COLOR TEST: 


PRESS ANY KEY 


RAM TEST 

PAGE : FFF . 
BitO OK Bit3 OK Bit6 OK 
Bitl OK Bit4 OK Bit7 OK 
Bit2 OK Bit5 OK 


If there has any bad RAM on BASE, the BASE will display: 
Bit # ERR. 
You should change the RAM to let the BASE back to normal. 


Cat. 


REM 


[F2) + Lz] 

| F2 ] + [1 ] = POKE 
[F2 | + [2 ] = PEEK 
[F2 |] + [3] = soR 
| F2 | + [ 4 ] = RND 
[F2]+ [5 ]= LOG 
| F2]+ [6 ] = EXP 
[F2 ] + [7 ]= cos 
[F2]+ [8 ]= SIN 
[F2 ]+ [9 ]= TAN 
[F2 ]+ [0 ]= DEG 
[F2 ]+ [- ] = COLOR 


MORE DETAIL OF 


LOAD 


DIM 


THE BASE’S FUNCTION KEYS 


Appendix D 


= ONERR 


2 
‘ 


[F2 ]+ [] ]= HGR 
[F2 ] + [/ ] = HGR2 
[ F2 |] + [; |= INPUT 
[F2|]+ [, ]= HIM 
[-F2 ] + [. ] = Lom 
[F2 ] + [2 ] = CHR$ 
[F2 ] + [/ |= GET 


**{ Fl | + [o | = LIST 


m 
O 


JBRBHREHEE 
SHSHGRRRE 


READ 


SAVE 


es eats ae 
[F2] + [uU_] = USR 
[| F2 |] + [ v_] = VTAB 
pea] + Ew) 


= PLOT 


= PR# 


DELETE 


La] + 1] 


IN# 


Fl] + L4J=< 

[Fl] + [5] = Text 
[Fl ]+[6]= —> 

[Fl] + (:7_] = HOME 
Efi] + fel]= 7 

[Fi] + [9 ] = RUN 
[Fr] + (2) = cree 
[Esc ] + [0 ] = PR#O0 
[Esc ] + [1 ] = PR#1 
[esc ] + [2] = pPR#2 
[Esc ] + [3 ] = PR#3 
ESC ] + [4 ] = PR#4 
[esc ] + [5 ] = PR#5 
ESC | + [ 6 ] = PR#6 
Esc ] + [7 | = PR#7 


* Plus sign means these key being pressed at the same time. 


7 key can be locked. 


—" 


rm = LA —$ 


Le 


ee es a 


m- 
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Appendix E How to check and repair your BASE 


HOOK UP THE BASE 
(a) Plug the keyboard connector into the socket which located on A7 position of P.C. board. 
(b) Plug the monitor input cable into BASE video output jack. 


(c) Plug the female connector of speaker on male connector which located on K 14 position of P.C. 
board. 


(d) Plug the power cord. 
TURN ON THE POWER. 


When you turn on the power, the speaker will sound a ‘beep’ if you have a 48 type of the BASE 
otherwise you will hear a few notes of music since your BASE is 64A type, then the screen will display 
the ‘BASE 48” or ‘‘BASE 64A” according to what type of the BASE you have. 


FUNCTION TEST OF BASE 
(1) For BASE 48 


(a) Turn the monitor’s power on. 

(b) Turn on the computer's power. 

(c) Monitor should display ‘‘BASE 48’', and you can hear ‘‘beep’’ sound, the ‘‘beep’’ sound just 
tells you the BASE is ready. 

(d) Key in PRINT FRE = (0) statement, then press RETURN, the screen will display-18435. 

(e) CTRL—G command will let speaker sound a “‘beep’’ sound. 

(f) Key in ““RETURN” the screen will display ‘’? SYNTAX ERROR”. 

(g) Key in “INVERSE”, then press “RETURN”, the prompt character ‘’] ’’ will inverse. 

(h) Key in PRINT “ABCDE”, then press ““RETURN”, the screen will display ‘‘ABCDE” in inverse 
form, the background is white and character is black. 

(i) Key in “NORMAL” then press ‘‘RETURN”, the prompt character will back to normal display. 
the background is black and character is white. 

(j) Key in ‘‘FLASH”, press ‘‘RETURN”, the prompt character will flash. 

(k) Key in PRINT ““ABCDE” statement, then press RETURN THE SCREEN WILL DISPLAY 
ABCDE in flash mode. 

(1) Key in “NORMAL” then press “RETURN”, the prompt character should go back to normal. 

(m) Key in “GR” statement, then ‘“-RETURN” the screen will be cleared. 

(n) Press CTRL—RESET, the screen will back to TEXT mode and three fourth of the screen will 
display inverse @. 

(o) Turn off the power and on again, the screen should display ‘BASE 48” and a sound “‘beep”’. 


After these testing, and your BASE is still O.K. then your BASE is in normal and good condition! 
(2) For BASE 64A 


(a) Turn the monitor’s power on. 
(b) Turn the computer's power on. 


(c) Key in TEST command, then press RETURN, the BASE will enter self test mode, it will 


check its own ROM, sound, Pattern, Color and RAM. 
|] TEST 


PRESS ANY KEY TO CONTINUE 


PRESS ANY KEY TO CONTINUE 

SOUND TEST: (Demo a song) 

PATTERN TEST: 
@ABCDEFGHIJKLMNOPQRSTUVWXYZ(/) !''#$%&’ 
()*+,-./0123456789:;=? !ABCDEFGHIJKLMNOP 
QRSTUVWXYZ(/) !#$%&’'()*+-./0123456789: 

: =? 


COLOR TEST: 


PRESS ANY KEY 


Bit 
Bit 


RAM TEST 
PAGE: FFF 
Bit 0 OK 
Bit 1 OK 
Bit 2 OK 
Bit 3 OK 
Bit 4 OK 
Bit 5 OK 

6 

Z 


TROUBLE SHOOTING 
(1) For BASE 48 (the BASE 48 CKT diagram is shown in last) 


(a) The trouble is: Turn on the power and the screen displays nothing. - 
1. Make sure your power supply is in good condition. 


2. Check the OSC CKT of the system which located on B2, B1, C1, C2. 


) Lecce | a ae, 


Li 
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3. Check the CPU BUS buffer F12, H10, H3, H4, H5. 
4. Check the related area which include B5, B6, B7, B8, ROM, RAM. 
(b) The trouble is: The “BASE 48” display on wrong place of the screen. 
Check D11,D12, D13, D14, E11, E12, E13, E14 these location. 
(c) The trouble is: Sync error. 
Check C11, C12, C13, C14, B11, B12, B13, B14 these location. 
(d) The trouble is: Turn on the power but BASE didn’t sound anything. 
1. Make sure your speaker is O.K. 
2. Check J13, F13, C11, R24, CR1, MPSA13, R23, C12 these location. 
(e) The trouble is: When you key in PRINT FRE (0) statement the computer didn’t Display- 
18435. 
1. Check F2, J1, E11, E13, E14 these location. 
2. Check your RAM. 
(f) The trouble is: Key in CTRL—G command but computer didn’t response a sound. 
1. Make sure your speaker is O.K. 
2. Check J13, F13, C11, R24, CR1, MPSA13, R23, C12 these location. 
3. Check B10, B6, B7. 
4. Check your ROM. 
(g) The trouble is: Key in INVERSE statement but computer don’t work. 
1. Check A5, B13, A3. 
2. Check ROM. 
(h) The trouble is: Key in NORMAL but computer don’t work. 
the same procedure of item (g). 
(i) The trouble is: Key in FLASH but computer don’t work: 
1. The same procodure of item (g). 
2. Check B3. 
(j) The trouble is: Key in GR statement but computer don’t work. 
1. Check H1,J1, F2, D2. 
2. Check E11, E12, E13, E14,D11, D12, 014, A2, B5, B6, B7, B8. 
3. Check RAM. 
- 4, Check C11, C12; €13, G14; B11, B12, B13; B14. 
(k) The trouble is: Worng color. 
Check B4, B9, A9, A10, A8, B10, R7, VC1, VC2. 
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(I) The trouble is: Worng Character. 
Check A5, A3, B5, B8. 


(m) The trouble is: The interface 1/0 don’t work. 
1. Check 1/0 bus buffer H12, H2, F12. 


2. Check timing of every slot. 


(n) The trouble is: Can’t save data on tape recoder. 


Check UA741, H14, F13. 


(o) The trouble is: Can’t load data from tape recoder. 


Check F13, J13, R19, R18. 

(p) The trouble is: Keyboard don’t work. 
1. Check B10, B6, B7. 
2. Check ROM. 


(2) For BASE 64A (the BASE 64A CKT diagram is shown in last) 


(a) The error appears on BASE '48 if also appeared on BASE 64A, their trouble shooting is in 
the same way. Because their hardware are quite the same. 

(b) The trouble is: When using the self-test of BASE 64A and find there has a non BASE 64A 
ROM: 
According to the bad ROM number change it will let it back to normal. 

(c) The trouble is: Using the self-test of BASE 64A and find there has a damaged RAM. Accoding 
to bit number change RAM 4164 on location D3-D10, bit 0 Change D3, bit 1 change D4 . .etc. 

(d) The trouble is: CP/M 56 or PASCAL can not RUN. 
Check F2, C3, C4, C5, C6; C7, E2, E3, E4, E5, E6, E7, E10. 
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BASE 64A Component Location Diagram 
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